# MCP server · Onto
> Six Onto tools in ChatGPT, Claude, Cursor and any MCP client: read, score, map and extract any page. Connect with one URL.

**Source:** /mcp-server
**Extracted:** 2026-09-24T18:14:20.201Z

---
Product · MCP Server

## Six tools. Any MCP client.

Give Claude, ChatGPT, Cursor or any MCP client six Onto tools — read a page as clean Markdown, score it, pull its structured data, map a site, or do fifty at once. Connect by URL, or run it locally with npx.

[Get started →](https://app.buildonto.dev/signup)[Connect a client](#connect)

[MCP docs ↗](https://docs.buildonto.dev/mcp)

6

tools

10+

clients with setup guides

Free

score\_url · the rest 1 credit

A tool call

### What happens when your agent reaches for Onto.

Five steps from your question to an answer from the page. Watch them, or click a step.

your client → api.buildonto.dev/mcp

You ask Claude, ChatGPT or Cursor about a page

1.  01You ask
    
    Your agent has no reader of its own for the page, so it looks at the tools it has.
    
2.  02It picks a tool
    
    One of Onto's six — here `read_url` and the URL.
    
3.  03The call reaches Onto
    
    Over the connector URL, signed in with your Onto account — or through the local `npx` server with a key.
    
4.  04The API call runs
    
    Each tool calls its `/v1` endpoint, so the credits are the API's, charged once.
    
5.  05Markdown comes back
    
    The agent reads the clean page and answers from it.
    

Clean Markdown in the chat, billed like any API call

The tools

### Six tools, one key.

What each takes, what it hands the model, and what it costs — plus the block to paste for a local server.

read\_url1 creditThe page as clean Markdown, then its sizes and whether it came from the cache.read\_and\_score1 creditThe Markdown with its AIO score and hallucination risk — the default when the agent should know how far to trust a page.score\_urlFreeThe score, what works, what costs points and what to fix — without the content.extract\_data1 creditThe JSON-LD, OpenGraph and meta tags the page declares. Pattern matching, no model.map\_site1 creditA site's URLs from its sitemap, or the first page's links — up to 1,000.batch1 per URLUp to 50 URLs read, scored or extracted in one call. Failures are refunded.

`read_url(url, fresh?)`_what the model reads_

\# Pricing & Fees
\> Find Stripe fees and pricing information…
\## Standard
Access a complete payments platform with simple,
pay-as-you-go pricing. No setup fees, monthly fees,
or hidden fees.
…
\*\*Source metadata (from Onto):\*\*
\- Original size: 699 KB
\- Cleaned size: 17 KB
\- Reduction: 97.6%
\- Cache: MISS
⚡ Onto · 699KB → 17KB · 97.6% smaller · ~175K tokens saved · buildonto.dev

Example · stripe.com/pricing, scanned 23 Sep 2026 · cut with “…”

`mcpServers · local stdio server`Copy

{
  "mcpServers": {
    "onto": {
      "command": "npx",
      "args": \["-y", "@ontosdk/mcp@latest"\],
      "env": { "ONTO\_API\_KEY": "onto\_sk\_live\_…" }
    }
  }
}

1.  01**Paste** the block with your `onto_sk_` key. `npx` fetches the server — Node 20 or later.
2.  02**Restart** your client. The six tools appear with their names, descriptions and input schemas.
3.  03**Ask.** Calls spend your account's credits, the same as the API.

Connect

### By URL, or locally. Same six tools.

The hosted connector needs no install — paste one URL and sign in with your Onto account. The local server runs on your machine with an API key.

No install

#### Hosted connector

Add a custom connector, paste the URL, and approve it with your Onto account — OAuth, so there's no key to paste.

`https://api.buildonto.dev/mcp`

ChatGPT, Claude, Claude Code, Codex, Cursor

[Connector guide ↗](https://docs.buildonto.dev/mcp/remote)

Local

#### stdio server

One `mcpServers` block with your `onto_sk_` key, then restart the client. Needs Node 20 or later.

`npx -y @ontosdk/mcp@latest`

For editors and CLIs that run MCP servers locally

[Setup for your client ↗](https://docs.buildonto.dev/mcp/setup)

*   ![](/_next/image?url=%2Fchatgpt.webp&w=48&q=75)**ChatGPT**By URL
*   ![](/_next/image?url=%2Fanthropic.png&w=48&q=75)**Claude**By URL
*   ![](/_next/image?url=%2Fanthropic.png&w=48&q=75)**Claude Code**By URL or config
*   ![](/_next/image?url=%2Fcodex.png&w=48&q=75)**Codex**By URL or config
*   ![](/_next/image?url=%2Fcursor.png&w=48&q=75)**Cursor**By URL or config
*   ![](/_next/image?url=%2Fwindsurf.png&w=48&q=75)**Windsurf**Local config
*   ![](/_next/image?url=%2Fcline.png&w=48&q=75)**Cline**Local config
*   ![](/_next/image?url=%2Fcontinue.png&w=48&q=75)**Continue**Local config
*   ![](/_next/image?url=%2Fzed.png&w=48&q=75)**Zed**Local config
*   ![](/_next/image?url=%2Fopencode.png&w=48&q=75)**opencode**Local config

See it first

### What an agent gets from your page.

The tools read pages the way this scan does. Run it on yours — the free Score tab shows the score and the Markdown a tool would hand your agent.

ReadBatchScorefreeRead & scoreMapExtract

https://free scan

Show:MarkdownJSON

Get codeScanfree

Trystripe.com/pricingvercel.com/pricinglinear.app/pricing

Pricing

### Tool calls spend your Read credits.

No separate MCP plan: each call costs what the API call behind it costs, from the same monthly credits.

2 concurrent · hard monthly cap

$0forever

1,000 credits / month

[Start free](https://app.buildonto.dev/signup)

Includes

*   Read · Score · MCP server
*   Clean Markdown + AIO accuracy score
*   Community support

5 concurrent · top up with credits

$9/ month

10,000 credits / month

[Upgrade to Starter](https://app.buildonto.dev/read/billing)

Includes

*   Everything in Free
*   Credit packs unlock overage
*   Email support

20 concurrent · top up with credits

$49/ month

100,000 credits / month

[Upgrade to Growth](https://app.buildonto.dev/read/billing)

Includes

*   Everything in Starter
*   10× Starter's monthly credits
*   Credit packs unlock overage

50 concurrent · shared Slack

$250/ month

500,000 credits / month

[Upgrade to Scale](https://app.buildonto.dev/read/billing)

Includes

*   Everything in Growth
*   Shared Slack support
*   50 reads in flight at once

Questions

### Before you connect.

01Do I need an Onto account?

Yes. The hosted connector signs you in with your Onto account; the local server needs an onto\_sk\_ API key and won't start without one. The free tier is 1,000 credits a month, with no card.

02Which clients work?

Any client that speaks MCP. The docs walk through ChatGPT, Claude, Claude Code, Claude Desktop, Codex, Cursor, Windsurf, Cline, Continue, Zed and opencode — [setup for each](https://docs.buildonto.dev/mcp/setup).

03What does a tool call cost?

The same as the API call behind it: 1 credit for read\_url, read\_and\_score, extract\_data and map\_site; score\_url is free; batch is 1 per URL, with failures refunded. It all comes out of the same monthly credits as the API.

04What does the model actually get back?

Text written for the model to read, not JSON — the Markdown or the score, with its details, and a last line like `⚡ Onto · 699KB → 17KB · 97.6% smaller · buildonto.dev`.

05Is it open source?

`@ontosdk/mcp` is MIT-licensed on npm, so you can read exactly how each tool is built. The cleaning and scoring run on Onto's API.

06What happens when my credits run out?

The tool call fails with a plain message the client shows in the chat — for example, that your monthly quota is used up. Nothing is charged for a failed call. Top up with a credit pack on a paid plan, or wait for the month to reset.

07How do I change my API key?

Create a new one in [the dashboard](https://app.buildonto.dev/read/keys) — that revokes the old one at once, since an account has one active key. Put the new key in your client's config and restart it. The hosted connector isn't affected by key changes.

08How does it stay up to date?

The config runs `@ontosdk/mcp@latest`, so a restart picks up a new version. The local server also tells you, in its report line, when one is out. The hosted connector is always current.

Get started

### Give your agent six tools it already understands.

1,000 credits a month, free — the same credits as the Read API.

[Get started →](https://app.buildonto.dev/signup)[See the Read API](/read-api)

Free tier · 1,000 credits / month · no card required

---
## Structured Data (JSON-LD)
```json
{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@type": "Organization",
      "@id": "https://buildonto.dev/#org",
      "name": "Onto",
      "url": "https://buildonto.dev",
      "logo": "https://buildonto.dev/icon.png",
      "sameAs": [
        "https://x.com/buildonto",
        "https://github.com/ravixalgorithm/ontosdk"
      ]
    },
    {
      "@type": "WebSite",
      "@id": "https://buildonto.dev/#site",
      "url": "https://buildonto.dev",
      "name": "Onto",
      "publisher": {
        "@id": "https://buildonto.dev/#org"
      }
    },
    {
      "@type": "SoftwareApplication",
      "name": "Onto",
      "applicationCategory": "DeveloperApplication",
      "operatingSystem": "Web",
      "url": "https://buildonto.dev",
      "description": "Onto serves AI agents clean Markdown from your own site, at the same URL, and shows you which agents came. Plus the AIO score, a Read API and an MCP server.",
      "publisher": {
        "@id": "https://buildonto.dev/#org"
      },
      "offers": {
        "@type": "Offer",
        "price": "0",
        "priceCurrency": "USD",
        "description": "Free tier: 1,000 credits / month"
      }
    }
  ]
}
```
