@ontosdk/mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Onto
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,166 @@
+# Onto MCP Server
+
+The official Onto Model Context Protocol server. Add clean web content reading and AI-readability scoring to Claude Code, Cursor, Cline, Zed, or any MCP-compatible AI client.
+
+## What this does
+
+Onto's MCP server exposes three tools to any AI agent:
+
+- **`read_url`** — Read any URL and get back clean, agent-ready Markdown (typically 10× smaller than raw HTML)
+- **`score_url`** — Get the AIO (AI-readability) score for any URL with a breakdown of what helps and what hurts AI consumption
+- **`read_and_score`** — Both at once: clean content plus quality assessment so the agent knows how much to trust the source
+
+This is the official MCP wrapper for the [Onto Read API](https://api.buildonto.dev).
+
+## Why use this?
+
+When AI agents read websites today, they parse hundreds of KB of React noise to find a few KB of actual content. This burns tokens and causes hallucinations.
+
+Onto strips the noise server-side, returns the agent-ready format, and reports a confidence score for the source. One tool call, one accurate answer.
+
+## Quick start
+
+### 1. Get an Onto API key
+
+Sign up at [app.buildonto.dev](https://app.buildonto.dev) and create an API key at **Read → Keys**.
+
+Free tier: 1,000 requests / month. No credit card.
+
+### 2. Install in Claude Code
+
+Add to your Claude Code MCP config:
+
+```json
+{
+  "mcpServers": {
+    "onto": {
+      "command": "npx",
+      "args": ["-y", "@ontosdk/mcp"],
+      "env": {
+        "ONTO_API_KEY": "onto_sk_live_your_key_here"
+      }
+    }
+  }
+}
+```
+
+Restart Claude Code. The `read_url`, `score_url`, and `read_and_score` tools will appear in the available tools list.
+
+### 3. Install in Cursor
+
+Add to Cursor's MCP configuration (Settings → Features → MCP):
+
+```json
+{
+  "mcpServers": {
+    "onto": {
+      "command": "npx",
+      "args": ["-y", "@ontosdk/mcp"],
+      "env": {
+        "ONTO_API_KEY": "onto_sk_live_your_key_here"
+      }
+    }
+  }
+}
+```
+
+See [`examples/`](./examples/) for Cline, Zed, and Continue configs.
+
+### 4. Use it
+
+In Claude Code or Cursor, try:
+
+> Read https://stripe.com/pricing using Onto and summarize the pricing tiers.
+
+The agent calls `read_url`, gets clean Markdown, and returns an accurate summary without parsing hundreds of KB of layout HTML.
+
+## Tools
+
+### `read_url`
+
+Returns clean Markdown for a URL with metadata about the extraction (sizes, reduction %, cache state).
+
+**Input:**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `url` | string | yes | Publicly accessible HTTP(S) URL |
+| `fresh` | boolean | no | If true, bypass cache (default: false) |
+
+### `score_url`
+
+Returns the AIO (AI-readability) score for a URL — 0-100 with a letter grade, hallucination risk, and a structured list of penalties / benefits / recommendations.
+
+**Input:**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `url` | string | yes | URL to score |
+
+### `read_and_score`
+
+Returns clean Markdown plus the AIO score in one call. Recommended default for agentic workflows.
+
+**Input:** same as `read_url`.
+
+## Pricing
+
+| Tier | Monthly requests | Price |
+|---|---|---|
+| Free | 1,000 | $0 |
+| Starter | 10,000 | $9 |
+| Growth | 100,000 | $49 |
+| Scale | 500,000 | $250 |
+| Enterprise | Custom | Contact sales |
+
+Manage your subscription at [app.buildonto.dev/read/billing](https://app.buildonto.dev/read/billing). Credit packs ($5–$200) are available for overflow once you're on a paid tier.
+
+## Configuration
+
+Environment variables:
+
+- `ONTO_API_KEY` (required) — Your Onto API key from [app.buildonto.dev/read/keys](https://app.buildonto.dev/read/keys)
+- `ONTO_API_BASE` (optional) — Override the API base URL (default: `https://api.buildonto.dev`)
+
+## Troubleshooting
+
+### "Invalid Onto API key"
+
+Verify your key at [app.buildonto.dev/read/keys](https://app.buildonto.dev/read/keys). If you recently rotated keys, your MCP config may have a stale value.
+
+### "Monthly quota exceeded"
+
+You've used your monthly allotment. Upgrade at [app.buildonto.dev/read/billing](https://app.buildonto.dev/read/billing) or wait for the monthly reset. Paid tiers can also top up with credit packs.
+
+### Tool doesn't appear in Claude Code / Cursor
+
+1. Verify the config file is valid JSON
+2. Restart the MCP host (Claude Code, Cursor, etc.)
+3. Check the host's MCP logs for connection errors
+4. Make sure `npx` is on your PATH
+
+### "Request timed out"
+
+The target site may be slow or unreachable. Onto's request timeout is 15 seconds. Retry, or try a different URL.
+
+## Links
+
+- Onto homepage: [buildonto.dev](https://buildonto.dev)
+- API documentation: [docs.buildonto.dev](https://docs.buildonto.dev)
+- Dashboard: [app.buildonto.dev](https://app.buildonto.dev)
+- GitHub issues: [github.com/ravixalgorithm/onto-mcp/issues](https://github.com/ravixalgorithm/onto-mcp/issues)
+- Contact: [founder@buildonto.dev](mailto:founder@buildonto.dev)
+
+## About Onto
+
+Onto is the compatibility layer for the agent web. Three products on one engine:
+
+- **Read** (this MCP server + API) — AI developers read any URL cleanly
+- **Serve** ([Next.js SDK](https://www.npmjs.com/package/@ontosdk/next)) — Site owners serve clean Markdown to AI crawlers
+- **Act** (coming Q3 2026) — Agents act on websites through semantic intent
+
+Built for AI agents reading the web. Built so they read it correctly.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { readUrl, readUrlInputSchema, type ReadUrlInput } from './tools/read.js';
+export { scoreUrl, scoreUrlInputSchema, type ScoreUrlInput } from './tools/score.js';
+export { readAndScore, readAndScoreInputSchema, type ReadAndScoreInput, } from './tools/read-and-score.js';
+export { callOntoApi, OntoApiError } from './lib/api-client.js';
+export type { ReadResponse, ScoreResponse, ReadAndScoreResponse, Recommendation, } from './lib/types.js';
+export { version } from './lib/version.js';

package/dist/index.js

@@ -0,0 +1,9 @@
+/* Programmatic exports for embedding the Onto tools in custom MCP setups.
+ * Most users should run the bin via `npx @ontosdk/mcp`; this file is for
+ * power users wiring tools into their own Server instance. */
+export { readUrl, readUrlInputSchema } from './tools/read.js';
+export { scoreUrl, scoreUrlInputSchema } from './tools/score.js';
+export { readAndScore, readAndScoreInputSchema, } from './tools/read-and-score.js';
+export { callOntoApi, OntoApiError } from './lib/api-client.js';
+export { version } from './lib/version.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;8DAE8D;AAE9D,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAqB,MAAM,iBAAiB,CAAC;AACjF,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAsB,MAAM,kBAAkB,CAAC;AACrF,OAAO,EACL,YAAY,EACZ,uBAAuB,GAExB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAOhE,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/lib/api-client.d.ts

@@ -0,0 +1,11 @@
+export declare class OntoApiError extends Error {
+    readonly status: number;
+    readonly code?: string | undefined;
+    constructor(message: string, status: number, code?: string | undefined);
+}
+interface CallOptions {
+    body: unknown;
+    signal?: AbortSignal;
+}
+export declare function callOntoApi<T>(endpoint: string, options: CallOptions): Promise<T>;
+export {};

package/dist/lib/api-client.js

@@ -0,0 +1,88 @@
+/* Thin HTTP wrapper around the Onto Read API. Reads ONTO_API_KEY at call time
+ * (not module-load) so server.ts can fail with a clean error message first. */
+import { version as PACKAGE_VERSION } from './version.js';
+const DEFAULT_BASE = 'https://api.buildonto.dev';
+const REQUEST_TIMEOUT_MS = 15_000;
+export class OntoApiError extends Error {
+    status;
+    code;
+    constructor(message, status, code) {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.name = 'OntoApiError';
+    }
+}
+export async function callOntoApi(endpoint, options) {
+    const apiKey = process.env.ONTO_API_KEY;
+    if (!apiKey) {
+        throw new OntoApiError('ONTO_API_KEY environment variable is not set. Get a key at https://app.buildonto.dev/read/keys', 0, 'NO_API_KEY');
+    }
+    const base = process.env.ONTO_API_BASE ?? DEFAULT_BASE;
+    const url = `${base}${endpoint}`;
+    const timeout = AbortSignal.timeout(REQUEST_TIMEOUT_MS);
+    const signal = options.signal
+        ? AbortSignal.any([options.signal, timeout])
+        : timeout;
+    let response;
+    try {
+        response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                Authorization: `Bearer ${apiKey}`,
+                'Content-Type': 'application/json',
+                'User-Agent': `@ontosdk/mcp/${PACKAGE_VERSION}`,
+            },
+            body: JSON.stringify(options.body),
+            signal,
+        });
+    }
+    catch (err) {
+        if (err instanceof DOMException && err.name === 'TimeoutError') {
+            throw new OntoApiError(`Onto API request timed out after ${REQUEST_TIMEOUT_MS / 1000}s. The target site may be slow or unreachable.`, 0, 'TIMEOUT');
+        }
+        throw new OntoApiError(`Failed to reach Onto API at ${base}: ${err.message}`, 0, 'NETWORK_ERROR');
+    }
+    const rawBody = await response.text();
+    if (!response.ok) {
+        let parsed = {};
+        try {
+            parsed = JSON.parse(rawBody);
+        }
+        catch {
+            // Body wasn't JSON; fall through with status-code-only error
+        }
+        const message = humanizeError(response.status, parsed);
+        throw new OntoApiError(message, response.status, parsed.error);
+    }
+    try {
+        return JSON.parse(rawBody);
+    }
+    catch (err) {
+        throw new OntoApiError(`Onto API returned invalid JSON: ${err.message}`, response.status, 'INVALID_RESPONSE');
+    }
+}
+function humanizeError(status, body) {
+    if (status === 401) {
+        return 'Invalid Onto API key. Verify your key at https://app.buildonto.dev/read/keys';
+    }
+    if (status === 402) {
+        return (body.message ??
+            'Monthly plan quota exceeded and credit balance is empty. Top up credits at https://app.buildonto.dev/read/billing');
+    }
+    if (status === 403) {
+        if (body.error === 'ROBOTS_BLOCKED') {
+            return body.message ?? 'The target site blocks AI crawlers via robots.txt.';
+        }
+        return body.message ?? 'Forbidden.';
+    }
+    if (status === 429) {
+        return (body.message ??
+            'Onto API rate limit exceeded. Upgrade your tier at https://app.buildonto.dev/read/billing or wait for the monthly reset.');
+    }
+    if (status >= 500) {
+        return body.message ?? `Onto API server error (${status}). Try again in a moment.`;
+    }
+    return body.message ?? `Onto API returned ${status}.`;
+}
+//# sourceMappingURL=api-client.js.map

package/dist/lib/api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../../src/lib/api-client.ts"],"names":[],"mappings":"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"}

package/dist/lib/errors.d.ts

@@ -0,0 +1,2 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+export declare function formatToolError(error: unknown): CallToolResult;

package/dist/lib/errors.js

@@ -0,0 +1,24 @@
+/* Format errors as MCP tool responses. We don't throw McpError for
+ * tool-call failures — the AI host shows tool errors to the user as
+ * unhelpful internal-error messages. Returning isError: true with a
+ * text body lets the model see what went wrong and recover. */
+import { OntoApiError } from './api-client.js';
+export function formatToolError(error) {
+    if (error instanceof OntoApiError) {
+        return {
+            content: [{ type: 'text', text: error.message }],
+            isError: true,
+        };
+    }
+    const message = error instanceof Error ? error.message : String(error);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `Onto MCP error: ${message}\n\nTroubleshooting:\n- Verify ONTO_API_KEY is set and valid (https://app.buildonto.dev/read/keys)\n- Check the target URL is publicly accessible\n- Check your monthly quota at https://app.buildonto.dev/read/usage`,
+            },
+        ],
+        isError: true,
+    };
+}
+//# sourceMappingURL=errors.js.map

package/dist/lib/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA;;;+DAG+D;AAG/D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,KAAK,YAAY,YAAY,EAAE,CAAC;QAClC,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;YAChD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,mBAAmB,OAAO,uNAAuN;aACxP;SACF;QACD,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC"}

package/dist/lib/types.d.ts

@@ -0,0 +1,76 @@
+export interface ReadResponse {
+    status: 'success';
+    url: string;
+    markdown: string;
+    metadata: {
+        title: string;
+        description: string;
+        language?: string;
+    };
+    stats: {
+        raw_html_size_kb: number;
+        markdown_size_kb: number;
+        reduction_percent: number;
+        extraction_time_ms: number;
+    };
+    cache: {
+        hit: boolean;
+        ttl_seconds: number;
+    };
+}
+export interface Recommendation {
+    title?: string;
+    description?: string;
+    priority?: 'High' | 'Medium' | 'Low' | string;
+    [key: string]: unknown;
+}
+export interface ScoreResponse {
+    status: 'success';
+    url: string;
+    aio_score: number;
+    grade: string;
+    hallucination_risk: 'low' | 'medium' | 'high';
+    insights: Record<string, boolean>;
+    penalties: string[];
+    benefits: string[];
+    recommendations: Recommendation[];
+    stats: {
+        raw_size: string;
+        efficiency: string;
+        extraction_time_ms: number;
+    };
+    bot_preview?: unknown;
+}
+export interface ReadAndScoreResponse {
+    status: 'success';
+    url: string;
+    markdown: string;
+    metadata: {
+        title: string;
+        description: string;
+        language?: string;
+    };
+    aio_score: number;
+    grade: string;
+    hallucination_risk: 'low' | 'medium' | 'high';
+    insights: Record<string, boolean>;
+    penalties: string[];
+    benefits: string[];
+    recommendations: Recommendation[];
+    stats: {
+        raw_html_size_kb: number;
+        markdown_size_kb: number;
+        reduction_percent: number;
+        extraction_time_ms: number;
+    };
+    cache: {
+        hit: boolean;
+        ttl_seconds: number;
+    };
+}
+export interface ApiErrorBody {
+    status: 'error';
+    error: string;
+    message: string;
+    details?: Record<string, unknown>;
+}

package/dist/lib/types.js

@@ -0,0 +1,4 @@
+/* Response shapes from the Onto Read API. These mirror onto-api/app/v1/*.
+ * If the API shape changes, update here. */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"AAAA;4CAC4C"}

package/dist/lib/version.d.ts

@@ -0,0 +1 @@
+export declare const version = "1.0.0";

package/dist/lib/version.js

@@ -0,0 +1,2 @@
+export const version = '1.0.0';
+//# sourceMappingURL=version.js.map

package/dist/lib/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/lib/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/server.js

@@ -0,0 +1,125 @@
+#!/usr/bin/env node
+/* Onto MCP Server — exposes the Onto Read API as Model Context Protocol tools.
+ *
+ * Tools: read_url, score_url, read_and_score.
+ * Reads ONTO_API_KEY from env. Defaults base URL to https://api.buildonto.dev.
+ *
+ * Install in Claude Code:
+ *   "mcpServers": {
+ *     "onto": {
+ *       "command": "npx",
+ *       "args": ["-y", "@ontosdk/mcp"],
+ *       "env": { "ONTO_API_KEY": "onto_sk_live_..." }
+ *     }
+ *   }
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, ErrorCode, McpError, } from '@modelcontextprotocol/sdk/types.js';
+import { readUrl, readUrlInputSchema } from './tools/read.js';
+import { scoreUrl, scoreUrlInputSchema } from './tools/score.js';
+import { readAndScore, readAndScoreInputSchema } from './tools/read-and-score.js';
+import { version } from './lib/version.js';
+if (!process.env.ONTO_API_KEY) {
+    console.error('[onto-mcp] ONTO_API_KEY environment variable is required.');
+    console.error('[onto-mcp] Create a key at https://app.buildonto.dev/read/keys');
+    process.exit(1);
+}
+const server = new Server({ name: 'onto', version }, { capabilities: { tools: {} } });
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: [
+        {
+            name: 'read_url',
+            description: 'Read any URL and return clean, agent-ready Markdown. Strips HTML noise, preserves semantic content, and returns content optimized for AI consumption. Use this when you need to extract content from a website for an AI agent to process.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    url: {
+                        type: 'string',
+                        description: 'The URL to read. Must be a publicly accessible HTTP or HTTPS URL.',
+                    },
+                    fresh: {
+                        type: 'boolean',
+                        description: 'If true, bypass cache and fetch fresh content. Default false.',
+                        default: false,
+                    },
+                },
+                required: ['url'],
+            },
+        },
+        {
+            name: 'score_url',
+            description: 'Get the AIO (AI-readability) score for any URL. Returns a 0-100 score plus a list of penalties, benefits, and recommendations describing why the source is or is not well-suited for AI consumption. Use this to evaluate source quality before relying on it.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    url: {
+                        type: 'string',
+                        description: 'The URL to score.',
+                    },
+                },
+                required: ['url'],
+            },
+        },
+        {
+            name: 'read_and_score',
+            description: 'Read any URL and return both clean Markdown AND the AIO accuracy score in one call. The recommended default for most AI workflows — gives both content and quality assessment together, so the AI agent can decide how much to trust the content.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    url: {
+                        type: 'string',
+                        description: 'The URL to read and score.',
+                    },
+                    fresh: {
+                        type: 'boolean',
+                        description: 'If true, bypass cache and fetch fresh content. Default false.',
+                        default: false,
+                    },
+                },
+                required: ['url'],
+            },
+        },
+    ],
+}));
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        switch (name) {
+            case 'read_url': {
+                const validated = readUrlInputSchema.parse(args ?? {});
+                return await readUrl(validated);
+            }
+            case 'score_url': {
+                const validated = scoreUrlInputSchema.parse(args ?? {});
+                return await scoreUrl(validated);
+            }
+            case 'read_and_score': {
+                const validated = readAndScoreInputSchema.parse(args ?? {});
+                return await readAndScore(validated);
+            }
+            default:
+                throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
+        }
+    }
+    catch (error) {
+        if (error instanceof McpError)
+            throw error;
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: 'text', text: `Tool '${name}' failed: ${message}` }],
+            isError: true,
+        };
+    }
+});
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // stderr (not stdout) — stdout is reserved for MCP protocol frames
+    console.error(`[onto-mcp] v${version} listening on stdio`);
+}
+main().catch((err) => {
+    console.error('[onto-mcp] fatal:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,SAAS,EACT,QAAQ,GACT,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAClF,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE3C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;IAC9B,OAAO,CAAC,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC3E,OAAO,CAAC,KAAK,CAAC,gEAAgE,CAAC,CAAC;IAChF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EACzB,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAChC,CAAC;AAEF,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;IAC5D,KAAK,EAAE;QACL;YACE,IAAI,EAAE,UAAU;YAChB,WAAW,EACT,4OAA4O;YAC9O,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,GAAG,EAAE;wBACH,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,mEAAmE;qBACjF;oBACD,KAAK,EAAE;wBACL,IAAI,EAAE,SAAS;wBACf,WAAW,EAAE,+DAA+D;wBAC5E,OAAO,EAAE,KAAK;qBACf;iBACF;gBACD,QAAQ,EAAE,CAAC,KAAK,CAAC;aAClB;SACF;QACD;YACE,IAAI,EAAE,WAAW;YACjB,WAAW,EACT,gQAAgQ;YAClQ,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,GAAG,EAAE;wBACH,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,mBAAmB;qBACjC;iBACF;gBACD,QAAQ,EAAE,CAAC,KAAK,CAAC;aAClB;SACF;QACD;YACE,IAAI,EAAE,gBAAgB;YACtB,WAAW,EACT,mPAAmP;YACrP,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,GAAG,EAAE;wBACH,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,4BAA4B;qBAC1C;oBACD,KAAK,EAAE;wBACL,IAAI,EAAE,SAAS;wBACf,WAAW,EAAE,+DAA+D;wBAC5E,OAAO,EAAE,KAAK;qBACf;iBACF;gBACD,QAAQ,EAAE,CAAC,KAAK,CAAC;aAClB;SACF;KACF;CACF,CAAC,CAAC,CAAC;AAEJ,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAEjD,IAAI,CAAC;QACH,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,UAAU,CAAC,CAAC,CAAC;gBAChB,MAAM,SAAS,GAAG,kBAAkB,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;gBACvD,OAAO,MAAM,OAAO,CAAC,SAAS,CAAC,CAAC;YAClC,CAAC;YACD,KAAK,WAAW,CAAC,CAAC,CAAC;gBACjB,MAAM,SAAS,GAAG,mBAAmB,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;gBACxD,OAAO,MAAM,QAAQ,CAAC,SAAS,CAAC,CAAC;YACnC,CAAC;YACD,KAAK,gBAAgB,CAAC,CAAC,CAAC;gBACtB,MAAM,SAAS,GAAG,uBAAuB,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;gBAC5D,OAAO,MAAM,YAAY,CAAC,SAAS,CAAC,CAAC;YACvC,CAAC;YACD;gBACE,MAAM,IAAI,QAAQ,CAAC,SAAS,CAAC,cAAc,EAAE,iBAAiB,IAAI,EAAE,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,QAAQ;YAAE,MAAM,KAAK,CAAC;QAC3C,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,SAAS,IAAI,aAAa,OAAO,EAAE,EAAE,CAAC;YAC/E,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,mEAAmE;IACnE,OAAO,CAAC,KAAK,CAAC,eAAe,OAAO,qBAAqB,CAAC,CAAC;AAC7D,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC;IACxC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/tools/read-and-score.d.ts

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+export declare const readAndScoreInputSchema: z.ZodObject<{
+    url: z.ZodString;
+    fresh: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    fresh: boolean;
+}, {
+    url: string;
+    fresh?: boolean | undefined;
+}>;
+export type ReadAndScoreInput = z.infer<typeof readAndScoreInputSchema>;
+export declare function readAndScore(input: ReadAndScoreInput): Promise<CallToolResult>;

package/dist/tools/read-and-score.js

@@ -0,0 +1,43 @@
+import { z } from 'zod';
+import { callOntoApi } from '../lib/api-client.js';
+import { formatToolError } from '../lib/errors.js';
+export const readAndScoreInputSchema = z.object({
+    url: z.string().url(),
+    fresh: z.boolean().optional().default(false),
+});
+export async function readAndScore(input) {
+    try {
+        const result = await callOntoApi('/v1/read-and-score', {
+            body: { url: input.url, fresh: input.fresh },
+        });
+        const trustHint = trustLine(result.aio_score, result.hallucination_risk);
+        const summaryLines = [
+            `**Source quality assessment (from Onto):**`,
+            `- AIO Score: ${result.aio_score}/100 (${result.grade})`,
+            `- Hallucination risk: ${result.hallucination_risk}`,
+            `- Reduction: ${result.stats.reduction_percent}% (${result.stats.raw_html_size_kb} KB → ${result.stats.markdown_size_kb} KB)`,
+            `- Cache: ${result.cache.hit ? 'HIT' : 'MISS'}`,
+            '',
+            trustHint,
+        ];
+        return {
+            content: [
+                { type: 'text', text: result.markdown },
+                { type: 'text', text: `\n\n---\n\n${summaryLines.join('\n')}` },
+            ],
+        };
+    }
+    catch (error) {
+        return formatToolError(error);
+    }
+}
+function trustLine(score, risk) {
+    if (risk === 'high' || score < 40) {
+        return 'Trust signal: low — this source is poorly structured for AI consumption. Verify any facts before relying on them.';
+    }
+    if (risk === 'medium' || score < 70) {
+        return 'Trust signal: medium — source is partially AI-readable. Cross-check critical claims.';
+    }
+    return 'Trust signal: high — source is well-structured for AI consumption.';
+}
+//# sourceMappingURL=read-and-score.js.map

package/dist/tools/read-and-score.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-and-score.js","sourceRoot":"","sources":["../../src/tools/read-and-score.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGnD,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACrB,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CAC7C,CAAC,CAAC;AAIH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAAwB;IACzD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,WAAW,CAAuB,oBAAoB,EAAE;YAC3E,IAAI,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE;SAC7C,CAAC,CAAC;QAEH,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,kBAAkB,CAAC,CAAC;QACzE,MAAM,YAAY,GAAG;YACnB,4CAA4C;YAC5C,gBAAgB,MAAM,CAAC,SAAS,SAAS,MAAM,CAAC,KAAK,GAAG;YACxD,yBAAyB,MAAM,CAAC,kBAAkB,EAAE;YACpD,gBAAgB,MAAM,CAAC,KAAK,CAAC,iBAAiB,MAAM,MAAM,CAAC,KAAK,CAAC,gBAAgB,SAAS,MAAM,CAAC,KAAK,CAAC,gBAAgB,MAAM;YAC7H,YAAY,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE;YAC/C,EAAE;YACF,SAAS;SACV,CAAC;QAEF,OAAO;YACL,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE;gBAChD,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,cAAc,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE;aACzE;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,KAAa,EAAE,IAA+B;IAC/D,IAAI,IAAI,KAAK,MAAM,IAAI,KAAK,GAAG,EAAE,EAAE,CAAC;QAClC,OAAO,mHAAmH,CAAC;IAC7H,CAAC;IACD,IAAI,IAAI,KAAK,QAAQ,IAAI,KAAK,GAAG,EAAE,EAAE,CAAC;QACpC,OAAO,sFAAsF,CAAC;IAChG,CAAC;IACD,OAAO,oEAAoE,CAAC;AAC9E,CAAC"}

package/dist/tools/read.d.ts

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+export declare const readUrlInputSchema: z.ZodObject<{
+    url: z.ZodString;
+    fresh: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    fresh: boolean;
+}, {
+    url: string;
+    fresh?: boolean | undefined;
+}>;
+export type ReadUrlInput = z.infer<typeof readUrlInputSchema>;
+export declare function readUrl(input: ReadUrlInput): Promise<CallToolResult>;

package/dist/tools/read.js

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+import { callOntoApi } from '../lib/api-client.js';
+import { formatToolError } from '../lib/errors.js';
+export const readUrlInputSchema = z.object({
+    url: z.string().url(),
+    fresh: z.boolean().optional().default(false),
+});
+export async function readUrl(input) {
+    try {
+        const result = await callOntoApi('/v1/read', {
+            body: { url: input.url, fresh: input.fresh },
+        });
+        const metaLines = [
+            `- URL: ${result.url}`,
+            `- Title: ${result.metadata.title || '(none)'}`,
+            `- Original size: ${result.stats.raw_html_size_kb} KB`,
+            `- Cleaned size: ${result.stats.markdown_size_kb} KB`,
+            `- Reduction: ${result.stats.reduction_percent}%`,
+            `- Extraction time: ${result.stats.extraction_time_ms} ms`,
+            `- Cache: ${result.cache.hit ? 'HIT' : 'MISS'}`,
+        ].join('\n');
+        return {
+            content: [
+                { type: 'text', text: result.markdown },
+                {
+                    type: 'text',
+                    text: `\n\n---\n\n**Source metadata (from Onto):**\n${metaLines}`,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return formatToolError(error);
+    }
+}
+//# sourceMappingURL=read.js.map

package/dist/tools/read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.js","sourceRoot":"","sources":["../../src/tools/read.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGnD,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACrB,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CAC7C,CAAC,CAAC;AAIH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,KAAmB;IAC/C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,WAAW,CAAe,UAAU,EAAE;YACzD,IAAI,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE;SAC7C,CAAC,CAAC;QAEH,MAAM,SAAS,GAAG;YAChB,UAAU,MAAM,CAAC,GAAG,EAAE;YACtB,YAAY,MAAM,CAAC,QAAQ,CAAC,KAAK,IAAI,QAAQ,EAAE;YAC/C,oBAAoB,MAAM,CAAC,KAAK,CAAC,gBAAgB,KAAK;YACtD,mBAAmB,MAAM,CAAC,KAAK,CAAC,gBAAgB,KAAK;YACrD,gBAAgB,MAAM,CAAC,KAAK,CAAC,iBAAiB,GAAG;YACjD,sBAAsB,MAAM,CAAC,KAAK,CAAC,kBAAkB,KAAK;YAC1D,YAAY,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE;SAChD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,OAAO;YACL,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE;gBAChD;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,gDAAgD,SAAS,EAAE;iBAClE;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;AACH,CAAC"}

package/dist/tools/score.d.ts

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { ScoreResponse } from '../lib/types.js';
+export declare const scoreUrlInputSchema: z.ZodObject<{
+    url: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+}, {
+    url: string;
+}>;
+export type ScoreUrlInput = z.infer<typeof scoreUrlInputSchema>;
+export declare function scoreUrl(input: ScoreUrlInput): Promise<CallToolResult>;
+export declare function formatScoreSummary(result: ScoreResponse): string;

package/dist/tools/score.js

@@ -0,0 +1,71 @@
+import { z } from 'zod';
+import { callOntoApi } from '../lib/api-client.js';
+import { formatToolError } from '../lib/errors.js';
+export const scoreUrlInputSchema = z.object({
+    url: z.string().url(),
+});
+export async function scoreUrl(input) {
+    try {
+        const result = await callOntoApi('/v1/score', {
+            body: { url: input.url },
+        });
+        return {
+            content: [{ type: 'text', text: formatScoreSummary(result) }],
+        };
+    }
+    catch (error) {
+        return formatToolError(error);
+    }
+}
+export function formatScoreSummary(result) {
+    const lines = [
+        `**AIO Score:** ${result.aio_score}/100 (${result.grade})`,
+        `**Hallucination risk:** ${result.hallucination_risk}`,
+        `**URL:** ${result.url}`,
+        '',
+    ];
+    if (result.benefits.length > 0) {
+        lines.push('**What works well:**');
+        for (const item of result.benefits)
+            lines.push(`- ${item}`);
+        lines.push('');
+    }
+    if (result.penalties.length > 0) {
+        lines.push('**What hurts AI readability:**');
+        for (const item of result.penalties)
+            lines.push(`- ${item}`);
+        lines.push('');
+    }
+    const insightEntries = Object.entries(result.insights ?? {});
+    if (insightEntries.length > 0) {
+        lines.push('**Insights:**');
+        for (const [key, value] of insightEntries) {
+            lines.push(`- ${key}: ${value ? 'yes' : 'no'}`);
+        }
+        lines.push('');
+    }
+    if (result.recommendations.length > 0) {
+        lines.push('**Recommendations:**');
+        for (const rec of result.recommendations) {
+            lines.push(describeRecommendation(rec));
+        }
+        lines.push('');
+    }
+    lines.push('**Stats:**');
+    lines.push(`- Raw size: ${result.stats.raw_size}`);
+    lines.push(`- Efficiency: ${result.stats.efficiency}`);
+    lines.push(`- Extraction time: ${result.stats.extraction_time_ms} ms`);
+    return lines.join('\n');
+}
+function describeRecommendation(rec) {
+    if (typeof rec === 'string')
+        return `- ${rec}`;
+    if (rec.title) {
+        const head = rec.priority ? `**${rec.title}** _(priority: ${rec.priority})_` : `**${rec.title}**`;
+        return rec.description ? `- ${head} — ${rec.description}` : `- ${head}`;
+    }
+    if (rec.description)
+        return `- ${rec.description}`;
+    return `- ${JSON.stringify(rec)}`;
+}
+//# sourceMappingURL=score.js.map

package/dist/tools/score.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"score.js","sourceRoot":"","sources":["../../src/tools/score.ts"],"names":[],"mappings":"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"}

package/examples/claude-code.md

@@ -0,0 +1,48 @@
+# Onto MCP in Claude Code
+
+## Config location
+
+| OS | Path |
+|---|---|
+| macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |
+| Windows | `%APPDATA%\Claude\claude_desktop_config.json` |
+| Linux | `~/.config/Claude/claude_desktop_config.json` |
+
+Claude Code CLI users: the same `mcpServers` block can be added via `claude mcp add` or by editing `~/.claude/settings.json` and nesting under `mcpServers`.
+
+## Config block
+
+Add to the `mcpServers` object (create the key if it doesn't exist):
+
+```json
+{
+  "mcpServers": {
+    "onto": {
+      "command": "npx",
+      "args": ["-y", "@ontosdk/mcp"],
+      "env": {
+        "ONTO_API_KEY": "onto_sk_live_your_key_here"
+      }
+    }
+  }
+}
+```
+
+## Verify
+
+1. Restart Claude Code (fully quit and reopen — `Cmd/Ctrl+Q`, not just close window)
+2. Open a new chat
+3. Type: `What tools do I have available?`
+4. You should see `read_url`, `score_url`, and `read_and_score` in the list
+
+## Try it
+
+> Read https://news.ycombinator.com using Onto and tell me the top three stories.
+
+> Score https://example.com — is it well-structured for AI consumption?
+
+> Read https://stripe.com/pricing using Onto and summarize each plan.
+
+## Where to get an API key
+
+[app.buildonto.dev/read/keys](https://app.buildonto.dev/read/keys) — free tier includes 1,000 requests/month, no credit card.

package/examples/cline.md

@@ -0,0 +1,33 @@
+# Onto MCP in Cline (VS Code)
+
+## Setup
+
+1. Install the [Cline](https://marketplace.visualstudio.com/items?itemName=saoudrizwan.claude-dev) extension in VS Code
+2. Open the Cline panel → click the MCP icon → "Edit MCP Settings"
+3. Add the Onto block to `cline_mcp_settings.json`
+
+## Config block
+
+```json
+{
+  "mcpServers": {
+    "onto": {
+      "command": "npx",
+      "args": ["-y", "@ontosdk/mcp"],
+      "env": {
+        "ONTO_API_KEY": "onto_sk_live_your_key_here"
+      },
+      "disabled": false,
+      "autoApprove": []
+    }
+  }
+}
+```
+
+## Verify
+
+The Cline MCP panel should show "onto" with three connected tools: `read_url`, `score_url`, `read_and_score`.
+
+## API key
+
+Get one at [app.buildonto.dev/read/keys](https://app.buildonto.dev/read/keys).

package/examples/cursor.md

@@ -0,0 +1,44 @@
+# Onto MCP in Cursor
+
+## Config location
+
+Cursor → Settings → Features → **Model Context Protocol** → "Add server"
+
+Or edit the config file directly:
+
+| OS | Path |
+|---|---|
+| macOS | `~/.cursor/mcp.json` |
+| Windows | `%USERPROFILE%\.cursor\mcp.json` |
+| Linux | `~/.cursor/mcp.json` |
+
+## Config block
+
+```json
+{
+  "mcpServers": {
+    "onto": {
+      "command": "npx",
+      "args": ["-y", "@ontosdk/mcp"],
+      "env": {
+        "ONTO_API_KEY": "onto_sk_live_your_key_here"
+      }
+    }
+  }
+}
+```
+
+## Verify
+
+1. Restart Cursor
+2. Open the Composer or Chat
+3. Ask: "What MCP tools are available?"
+4. `read_url`, `score_url`, `read_and_score` should be listed
+
+## Try it
+
+> Use Onto to read https://docs.cursor.com and summarize the @-symbol reference.
+
+## API key
+
+Get one at [app.buildonto.dev/read/keys](https://app.buildonto.dev/read/keys).

package/examples/zed.md

@@ -0,0 +1,41 @@
+# Onto MCP in Zed
+
+## Config location
+
+Zed → Settings → Open `settings.json`
+
+Or directly:
+
+| OS | Path |
+|---|---|
+| macOS | `~/.config/zed/settings.json` |
+| Linux | `~/.config/zed/settings.json` |
+| Windows | `%APPDATA%\Zed\settings.json` |
+
+## Config block
+
+Add (or merge with) the `context_servers` key:
+
+```json
+{
+  "context_servers": {
+    "onto": {
+      "command": {
+        "path": "npx",
+        "args": ["-y", "@ontosdk/mcp"],
+        "env": {
+          "ONTO_API_KEY": "onto_sk_live_your_key_here"
+        }
+      }
+    }
+  }
+}
+```
+
+## Verify
+
+Restart Zed. Open Assistant and check the context server status indicator — "onto" should appear as connected.
+
+## API key
+
+Get one at [app.buildonto.dev/read/keys](https://app.buildonto.dev/read/keys).

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@ontosdk/mcp",
+  "version": "1.0.0",
+  "description": "Official Onto MCP server — clean Markdown and AIO scoring for any URL, available as MCP tools for Claude Code, Cursor, and any MCP client.",
+  "type": "module",
+  "main": "./dist/server.js",
+  "bin": {
+    "onto-mcp": "./dist/server.js"
+  },
+  "files": [
+    "dist/**/*",
+    "examples/**/*",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch",
+    "start": "node dist/server.js",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.3.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "ai-agents",
+    "claude",
+    "cursor",
+    "onto",
+    "markdown",
+    "web-scraping",
+    "agent-tools",
+    "aio-score"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ravixalgorithm/onto-mcp.git"
+  },
+  "homepage": "https://buildonto.dev",
+  "bugs": {
+    "url": "https://github.com/ravixalgorithm/onto-mcp/issues"
+  },
+  "author": {
+    "name": "Onto",
+    "email": "founder@buildonto.dev",
+    "url": "https://buildonto.dev"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}