# Polylane Developers

> Everything you need to build against Polylane: the API, the MCP server, the CLI, the SDK, and how to authenticate. Polylane makes your software self-operating: AI agents that read your code, watch your infra, and fix production before you wake up.

Canonical: https://polylane.com/developers · Documentation: https://docs.polylane.com

## Quickstart

Polylane is pre-launch; early access has been rolling out since June 2026.

1. **Get access** — join the waitlist at https://polylane.com/#join (or `POST https://polylane.com/api/auth/email` with `{"name", "email"}`).
2. **Sign in** — once invited, sign in at https://console.polylane.com and connect a cloud account or repository.
3. **Mint an API key** — create a key (`sk_...`) in the console settings.
4. **First request**:

```
curl https://api.polylane.com/v1/auth/whoami -H "x-api-key: sk_..."
```

5. **Connect an agent** — point any MCP client at `https://mcp.polylane.com/mcp` (Streamable HTTP). OAuth clients can register themselves at `https://mcp.polylane.com/register`; API keys work as `Authorization: Bearer sk_...` or `x-api-key`.

## The Polylane API

- Base URL: `https://api.polylane.com/v1`
- OpenAPI 3.0 spec: https://api.polylane.com/v1/doc (mirrored at https://polylane.com/openapi.json)
- API catalog (RFC 9727): https://polylane.com/.well-known/api-catalog
- Authentication guide for agents: https://polylane.com/auth.md

## MCP servers

- **Product** (OAuth 2.0 or API key): `https://mcp.polylane.com/mcp` — tools `search`, `execute`, `searchTools`, `runTool`, `runCode`. Server card: https://mcp.polylane.com/.well-known/mcp/server-card.json
- **Docs** (no auth): `https://docs.polylane.com/mcp` — list and read every page of https://docs.polylane.com

## CLI

Built to be driven by coding agents: structured output and non-interactive flags everywhere.

```
curl -fsSL https://polylane.com/install.sh | bash        # macOS / Linux
irm https://polylane.com/install.ps1 | iex               # Windows
polylane auth signup --email you@example.com
```

## SDK

- npm: https://www.npmjs.com/package/@coreplane/polylane

## Rate limits

Requests are rate limited per credential. When you exceed a limit the API returns `429` — back off and honour `Retry-After` when present. Agents should treat any `429` as a signal to retry with exponential backoff rather than tight-looping.

## Versioning and deprecation

The API is versioned in the URL path (`/v1`). Breaking changes only ship in a new version. Deprecations are announced in the [build log](https://polylane.com/build-log) and documented in the [docs](https://docs.polylane.com) before removal; deprecated surfaces keep working during the transition window.

## Machine-readable entry points

- https://polylane.com/llms.txt — site index for agents
- https://polylane.com/agent.json — structured product view (also at https://polylane.com/?mode=agent)
- https://polylane.com/.well-known/mcp — MCP discovery
- https://polylane.com/.well-known/agent-card.json — A2A agent card
- https://polylane.com/.well-known/agent-skills/index.json — skills index

## Support

Email boris@coreplane.ai or reach us on X at https://x.com/polylanehq.