# Innernet v0.6 — full agent integration guide

Innernet is a self-hosted live-web runtime with two layers: 13 permanent Machines for primitive internet operations and Jobs for complete outcomes.

## Product model

Machines give agents tools. Jobs give agents outcomes.

Job modes:
- batch: one Machine across many inputs.
- recipe: a curated versioned execution graph.
- mission: a goal plus a maximum budget; the local planner chooses bounded Machine calls.
- watch: persistent observation; a trigger can create a Batch, Recipe or Mission child Job.

## Job lifecycle

quote -> pay/authorise -> queued -> planning -> running -> succeeded/failed/cancelled. Watch Jobs can also be paused/resumed. Completed Jobs expose a signed execution manifest.

## HTTP Jobs

POST https://innernetcorp.com/jobs/quote — free quote.
POST https://innernetcorp.com/jobs — create/authorise the quoted Job.
GET https://innernetcorp.com/jobs/:id — free state/events.
GET https://innernetcorp.com/jobs/:id/result — free result.
GET https://innernetcorp.com/jobs/:id/manifest — free signed manifest.
POST https://innernetcorp.com/jobs/:id/cancel — cancel.
POST https://innernetcorp.com/jobs/:id/pause — pause Watch.
POST https://innernetcorp.com/jobs/:id/resume — resume Watch.
GET https://innernetcorp.com/recipes — Recipe registry.

Example Batch quote:
```json
{
  "mode": "batch",
  "machine": "read",
  "inputs": [
    {
      "url": "https://example.com"
    },
    {
      "url": "https://example.org"
    }
  ],
  "concurrency": 2
}
```

Example Mission quote:
```json
{
  "mode": "mission",
  "goal": "Compare the latest public pricing and capabilities of three named vendors",
  "budget": {
    "max_usd": 0.5
  },
  "max_steps": 6
}
```

Example Watch quote:
```json
{
  "mode": "watch",
  "url": "https://example.com/pricing",
  "observe": "content",
  "interval_minutes": 60,
  "max_checks": 24,
  "max_triggers": 2,
  "trigger": {
    "type": "changed"
  },
  "action": {
    "mode": "mission",
    "request": {
      "goal": "Explain what changed on the monitored pricing page and its likely impact",
      "budget": {
        "max_usd": 0.25
      }
    }
  }
}
```

## Discovery

- Service manifest: https://innernetcorp.com/.well-known/innernet.json
- MCP manifest: https://innernetcorp.com/.well-known/mcp.json
- MCP endpoint: https://innernetcorp.com/mcp
- Catalog: https://innernetcorp.com/catalog
- Recipes: https://innernetcorp.com/recipes
- OpenAPI: https://innernetcorp.com/openapi.json
- x402/OpenAPI discovery: https://innernetcorp.com/.well-known/x402

## MCP

Use Streamable HTTP at https://innernetcorp.com/mcp. The server exposes all 13 Machine tools plus Job tools: quote_job, create_job, get_job, cancel_job, pause_watch_job, resume_watch_job and list_recipes.
Static-price Machines use native x402 MCP wrapping. Dynamic-price Jobs are quoted first; create_job accepts an x402 payment_signature for the quote.

Generic client config:
```json
{
  "mcpServers": {
    "innernet": {
      "url": "https://innernetcorp.com/mcp"
    }
  }
}
```

## Permanent Machines

### F1 · search

Search the public web through Innernet's self-hosted metasearch layer and return ranked, normalised results. Optional local-model reranking improves relevance without a cloud model API.

HTTP: POST https://innernetcorp.com/machines/search
MCP tool: search
Price: $0.01
Content type: application/json

Input schema:
```json
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string"
    },
    "max_results": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    },
    "topic": {
      "type": "string",
      "enum": [
        "general",
        "news"
      ]
    },
    "time_range": {
      "type": "string",
      "enum": [
        "day",
        "month",
        "year"
      ]
    },
    "language": {
      "type": "string"
    },
    "include_domains": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "exclude_domains": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "additionalProperties": false
}
```

Example input:
```json
{
  "query": "latest x402 ecosystem developments",
  "max_results": 8
}
```

### F2 · research

Start a bounded multi-source research job. Innernet plans searches with its local model, searches the web, reads primary sources, synthesises only from gathered evidence and returns numbered citations. Status polling is free.

HTTP: POST https://innernetcorp.com/machines/research
MCP tool: research
Price: $0.15
Content type: application/json

Input schema:
```json
{
  "type": "object",
  "required": [
    "question"
  ],
  "properties": {
    "question": {
      "type": "string"
    },
    "include_domains": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "exclude_domains": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "additionalProperties": false
}
```

Example input:
```json
{
  "question": "What are the most important recent developments in x402?"
}
```

### F3 · crawl

Crawl a bounded portion of one public site, respect robots.txt, follow internal links and return clean agent-readable page content and structure.

HTTP: POST https://innernetcorp.com/machines/crawl
MCP tool: crawl
Price: $0.02
Content type: application/json

Input schema:
```json
{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string"
    },
    "max_pages": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    },
    "max_depth": {
      "type": "integer",
      "minimum": 0,
      "maximum": 3
    },
    "max_chars_per_page": {
      "type": "integer"
    },
    "include_subdomains": {
      "type": "boolean"
    }
  },
  "additionalProperties": false
}
```

Example input:
```json
{
  "url": "https://example.com",
  "max_pages": 10,
  "max_depth": 2
}
```

### R1 · read

Turn a public web page into clean agent-readable Markdown with title, byline, excerpt, links and source URL.

HTTP: POST https://innernetcorp.com/machines/read
MCP tool: read
Price: $0.005
Content type: application/json

Input schema:
```json
{
  "type": "object",
  "properties": {
    "url": {
      "type": "string"
    },
    "html": {
      "type": "string"
    },
    "base_url": {
      "type": "string"
    }
  },
  "additionalProperties": false
}
```

Example input:
```json
{
  "url": "https://example.com"
}
```

### R2 · extract

Fetch a public page or accept supplied HTML and extract named fields using explicit CSS selectors. Deterministic and useful when a buyer already knows the page structure.

HTTP: POST https://innernetcorp.com/machines/extract
MCP tool: extract
Price: $0.005
Content type: application/json

Input schema:
```json
{
  "type": "object",
  "properties": {
    "url": {
      "type": "string"
    },
    "html": {
      "type": "string"
    },
    "base_url": {
      "type": "string"
    },
    "selectors": {
      "type": "object"
    }
  },
  "required": [
    "selectors"
  ],
  "additionalProperties": false
}
```

Example input:
```json
{
  "url": "https://example.com",
  "selectors": {
    "headline": "h1",
    "links": {
      "selector": "a",
      "attr": "href",
      "all": true
    }
  }
}
```

### R3 · document

Read a text-based PDF from a public URL or base64 bytes and return full text, per-page text and page count.

HTTP: POST https://innernetcorp.com/machines/document
MCP tool: document
Price: $0.007
Content type: application/json

Input schema:
```json
{
  "type": "object",
  "properties": {
    "url": {
      "type": "string"
    },
    "base64": {
      "type": "string"
    }
  },
  "additionalProperties": false
}
```

Example input:
```json
{
  "url": "https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf"
}
```

### S1 · render

Render a public URL or supplied HTML into a screenshot or PDF using an isolated real Chromium browser.

HTTP: POST https://innernetcorp.com/machines/render
MCP tool: render
Price: $0.01
Content type: image/png | image/jpeg | application/pdf

Input schema:
```json
{
  "type": "object",
  "properties": {
    "url": {
      "type": "string"
    },
    "html": {
      "type": "string"
    },
    "format": {
      "type": "string",
      "enum": [
        "png",
        "jpeg",
        "pdf"
      ]
    },
    "full_page": {
      "type": "boolean"
    },
    "width": {
      "type": "integer"
    },
    "height": {
      "type": "integer"
    },
    "wait_until": {
      "type": "string"
    },
    "delay_ms": {
      "type": "integer"
    },
    "quality": {
      "type": "integer"
    }
  },
  "additionalProperties": false
}
```

Example input:
```json
{
  "url": "https://example.com",
  "format": "png",
  "full_page": false,
  "width": 1280,
  "height": 800
}
```

### S2 · browser

Open a public website in isolated Chromium, perform bounded read-only navigation/search interactions, and return final page text with optional HTML or screenshot evidence. Network writes are blocked.

HTTP: POST https://innernetcorp.com/machines/browser
MCP tool: browser
Price: $0.025
Content type: application/json

Input schema:
```json
{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string"
    },
    "actions": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "return_html": {
      "type": "boolean"
    },
    "screenshot": {
      "type": "boolean"
    },
    "width": {
      "type": "integer"
    },
    "height": {
      "type": "integer"
    }
  },
  "additionalProperties": false
}
```

Example input:
```json
{
  "url": "https://example.com",
  "actions": [
    {
      "type": "click",
      "selector": "a"
    }
  ],
  "screenshot": false
}
```

### I1 · inspect

Inspect a public URL or hostname and return live HTTP, redirect, DNS and TLS facts including status, latency, resolved public IPs and certificate details.

HTTP: POST https://innernetcorp.com/machines/inspect
MCP tool: inspect
Price: $0.004
Content type: application/json

Input schema:
```json
{
  "type": "object",
  "properties": {
    "url": {
      "type": "string"
    },
    "host": {
      "type": "string"
    },
    "port": {
      "type": "integer"
    }
  },
  "additionalProperties": false
}
```

Example input:
```json
{
  "url": "https://example.com"
}
```

### I2 · resolve

Resolve a company, domain, URL or public person identity using live web evidence and Innernet's local model. Returns a likely canonical identity, confidence and cited search evidence.

HTTP: POST https://innernetcorp.com/machines/resolve
MCP tool: resolve
Price: $0.02
Content type: application/json

Input schema:
```json
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string"
    },
    "type": {
      "type": "string",
      "enum": [
        "auto",
        "company",
        "domain",
        "url",
        "person"
      ]
    }
  },
  "additionalProperties": false
}
```

Example input:
```json
{
  "query": "OpenAI",
  "type": "company"
}
```

### P1 · notarize

Create an Ed25519-signed timestamped receipt for content or an existing SHA-256 hash. Verification stays free and can also be done offline.

HTTP: POST https://innernetcorp.com/machines/notarize
MCP tool: notarize
Price: $0.003
Content type: application/json

Input schema:
```json
{
  "type": "object",
  "properties": {
    "data": {},
    "hash": {
      "type": "string"
    },
    "note": {
      "type": "string"
    }
  },
  "additionalProperties": false
}
```

Example input:
```json
{
  "data": "shipping-confirmation",
  "note": "order-123"
}
```

### P2 · snapshot

Fetch a public page, hash exact response bytes, optionally render and hash a screenshot, then sign a timestamped evidence manifest.

HTTP: POST https://innernetcorp.com/machines/snapshot
MCP tool: snapshot
Price: $0.015
Content type: application/json

Input schema:
```json
{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string"
    },
    "screenshot": {
      "type": "boolean"
    },
    "full_page": {
      "type": "boolean"
    },
    "width": {
      "type": "integer"
    },
    "height": {
      "type": "integer"
    },
    "delay_ms": {
      "type": "integer"
    },
    "note": {
      "type": "string"
    }
  },
  "additionalProperties": false
}
```

Example input:
```json
{
  "url": "https://example.com",
  "screenshot": true,
  "full_page": true
}
```

### W1 · watch

Create a bounded persistent watch on a public URL. Innernet periodically observes content or HTTP state, records changes and exposes a free status/event feed until the purchased check budget is consumed.

HTTP: POST https://innernetcorp.com/machines/watch
MCP tool: watch
Price: $0.05
Content type: application/json

Input schema:
```json
{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string"
    },
    "mode": {
      "type": "string",
      "enum": [
        "content",
        "http"
      ]
    },
    "interval_minutes": {
      "type": "integer"
    },
    "max_checks": {
      "type": "integer"
    }
  },
  "additionalProperties": false
}
```

Example input:
```json
{
  "url": "https://example.com/pricing",
  "mode": "content",
  "interval_minutes": 60,
  "max_checks": 12
}
```

## Safety and budget boundaries

- Public URL fetches are SSRF-filtered.
- Browser actions are bounded and network-layer writes are blocked.
- Mission plans have maximum step counts and maximum spend.
- Batch Jobs have item and concurrency ceilings.
- Watch Jobs have check and trigger ceilings, pause/resume/cancel controls and total quoted budgets.
- Buyer private keys are never required by the seller runtime.
- Signed Job manifests hash the requested outcome, plan, budget and result and are signed by the persistent Innernet Ed25519 notary key.
- Local Qwen is control-plane infrastructure; deterministic payment, network and budget policy remain outside the model.