# Agent setup

Connect the AstroWay API to AI agents over **MCP (Model Context Protocol)**. The same **630-tool** catalog is available two ways, both authenticated with your existing `aw_test_*` / `aw_live_*` keys:

- **Hosted (HTTP)** — `https://mcp.astroway.info/mcp`, zero install, Bearer-token auth.
- **Stdio (npx)** — `npx @astroway/mcp`, local subprocess, env-var auth, offline-ready.

Get a free key in the [dashboard](https://api.astroway.info/dashboard/sign-up), then pick your client.

## Choose your client

<CardGrid>
  <LinkCard title="Claude Desktop" href="/en/agent-setup/claude-desktop/" description="Hosted MCP via config" />
  <LinkCard title="Claude Code" href="/en/agent-setup/claude-code/" description="One CLI command" />
  <LinkCard title="Cursor" href="/en/agent-setup/cursor/" description="Hosted MCP via config" />
  <LinkCard title="VS Code" href="/en/agent-setup/vscode/" description="Copilot Chat, Agent mode" />
  <LinkCard title="Windsurf" href="/en/agent-setup/windsurf/" description="Cascade MCP" />
  <LinkCard title="Cline" href="/en/agent-setup/cline/" description="npx stdio package" />
  <LinkCard title="Codex CLI" href="/en/agent-setup/codex/" description="npx stdio package" />
</CardGrid>

## CI / raw HTTP

No client at all — the hosted endpoint speaks JSON-RPC over HTTP. List the tools with a Bearer token:

<Code lang="bash" title="terminal" code={`curl https://mcp.astroway.info/mcp \\
  -H "Authorization: Bearer aw_live_YOUR_KEY" \\
  -H "Content-Type: application/json" \\
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'`} />

## Machine-readable specs

Prefer wiring the REST API directly, or feeding a spec to your own agent?

- **OpenAPI** — [`/v1/openapi.json`](https://api.astroway.info/v1/openapi.json)
- **llms.txt** — [`/llms.txt`](https://api.astroway.info/llms.txt) · full text [`/llms-full.txt`](https://api.astroway.info/llms-full.txt)
- **Postman** — [`/postman/astroway-api.json`](https://api.astroway.info/postman/astroway-api.json)
- **SDKs** — [TypeScript, Python, PHP](https://api.astroway.info/sdk/)