# Copy2LLM developer docs

Copy2LLM (copy.computer) is the portable context layer between websites and AI. This page is the machine-readable developer entry: install, options, OpenAPI, MCP, and rate limits.

## When to use this

- Add a capture/review/send button to a site (script tag, React, or the agent skill).
- Extract clean Markdown from a live DOM with `copy2llm-core`.
- Configure position, theme, exclude selectors, Context Cart, or custom LLM endpoints.

Skip Copy2LLM as a hosted URL-fetch API. Extraction runs in the reader's browser.

## Install

Agent skill (fastest):

```bash
npx skills add vladzima/copy2llm
```

Script tag:

```html
<script src="https://copy.computer/copy2llm.js" defer
        data-position="bottom-right" data-theme="auto"></script>
```

React: `npm i copy2llm-react` then `<CopyToLLM position="bottom-right" theme="auto" />`.

Core only: `npm i copy2llm-core` then `extract(document)`.

## OpenAPI

The HTTP surface of this site is published at https://copy.computer/openapi.json. Endpoints have unique `operationId`s for function calling.

## MCP

First-party Streamable HTTP server:

- Discovery card: `GET /.well-known/mcp`
- Handshake: `POST /mcp` with JSON-RPC `initialize`
- Tools: `get_install_snippet`, `get_docs`

No authentication. Origin is checked when the header is present.

## Rate limits

JSON responses send RFC 9118 RateLimit headers:

```
RateLimit: "default";r=60;t=60
RateLimit-Policy: "default";q=60;w=60
```

This site is static plus a tiny MCP/health Worker. There is no paid quota. If you ever receive `429`, honor `Retry-After`.

## Errors

API errors are JSON:

```json
{ "error": { "code": "not_found", "message": "...", "hint": "..." } }
```

## Markdown

Send `Accept: text/markdown` to `/` or `/docs`. Responses include `Vary: Accept`. Sibling files also exist at `/index.md` and `/docs/index.md`.

## Links

- Homepage: https://copy.computer/
- OpenAPI: https://copy.computer/openapi.json
- llms.txt: https://copy.computer/llms.txt
- Skill: https://copy.computer/.well-known/agent-skills/copy2llm/SKILL.md
- GitHub: https://github.com/vladzima/copy2llm
- npm: https://www.npmjs.com/package/copy2llm-core
