# Astrail

> Astrail turns APIs, websites, and workflows into hosted MCP endpoints, agent tools, and owned SDK bundles.

Astrail is a hosted MCP runtime and SDK generation platform for AI agents. It can generate MCP servers from OpenAPI, Swagger, Redoc, YAML, JSON, API docs, public websites, curated presets, and workflow descriptions. The platform exposes reviewed tools over HTTP JSON-RPC, supports Code Mode with search_docs and no-eval execute, exports SDK bundles, and records runtime evidence such as trace ids, execution modes, logs, auth-required states, and permission denials.

## Primary Documentation
- [Docs home](https://astrail.dev/docs): Quickstart for hosted MCP endpoints, OpenAPI to MCP, website-to-MCP, Code Mode, SDK Factory, and runtime reference.
- [MCP generator pages](https://astrail.dev/mcp): Canonical pages for OpenAPI to MCP, API docs to MCP, Swagger to MCP, ChatGPT MCP tools, and Astrail.dev brand spelling.
- [Machine-readable docs JSON](https://astrail.dev/docs.json): Structured docs, product capabilities, search intents, summaries, and FAQs.
- [Full LLM documentation](https://astrail.dev/llms-full.txt): Expanded text index of Astrail documentation and blog guides.

## Docs
- [OpenAPI to MCP](https://astrail.dev/docs/openapi-to-mcp): Generate a hosted MCP server from an OpenAPI, Swagger, Redoc, YAML, or JSON API contract.
- [Website to MCP](https://astrail.dev/docs/website-to-mcp): Turn public pages and same-origin links into safe read tools for agents when a clean API is not available yet.
- [Code Mode for large APIs](https://astrail.dev/docs/code-mode): Use search_docs and no-eval execute so agents can work with large APIs without hundreds of tool definitions.
- [SDK Factory](https://astrail.dev/docs/sdk-factory): Export owned TypeScript, Python, CLI, docs, manifests, tests, and update workflows from a hosted MCP server.
- [Runtime permissions](https://astrail.dev/docs/runtime-permissions): Control which generated tools can call upstream APIs, require auth, access networks, and return runtime evidence.
- [MCP client setup](https://astrail.dev/docs/mcp-client-setup): Connect Astrail-hosted MCP endpoints to agents, editors, scripts, and internal runtimes over HTTP JSON-RPC.
- [ChatGPT and OpenAI Agents MCP setup](https://astrail.dev/docs/chatgpt-openai-agents-mcp): Use Astrail-hosted MCP endpoints with ChatGPT, OpenAI Agents, and custom agent runtimes that need reviewed tools.
- [Claude and Cursor MCP setup](https://astrail.dev/docs/claude-cursor-mcp-setup): Connect Astrail-hosted MCP servers to Claude, Cursor, editors, and local developer workflows.
- [Agent readiness score](https://astrail.dev/docs/agent-readiness-score): Evaluate whether an API, website, or workflow is ready to become reliable agent tooling.
- [MCP vs API vs SDK](https://astrail.dev/docs/mcp-vs-api-vs-sdk): Understand when agents should use MCP, when developers should call APIs directly, and when teams should export SDKs.
- [Secure agent tool deployment](https://astrail.dev/docs/secure-agent-tool-deployment): Ship MCP tools with auth, permission checks, network limits, logging, and review gates before agents call production systems.
- [OpenAPI spec quality checklist](https://astrail.dev/docs/openapi-spec-quality-checklist): Improve OpenAPI specs before generating MCP tools, SDKs, docs, endpoint maps, and agent-readable schemas.
- [Website crawler safety](https://astrail.dev/docs/website-crawler-safety): Use website-to-MCP without giving agents unrestricted browser access or unsafe network reach.
- [MCP observability](https://astrail.dev/docs/mcp-observability): Trace hosted MCP calls with execution modes, latency, upstream status, structured denials, and redacted runtime logs.
- [Internal API to MCP](https://astrail.dev/docs/internal-api-to-mcp): Turn private internal APIs into reviewed MCP tools for support, operations, sales engineering, and internal agents.
- [MCP marketplace templates](https://astrail.dev/docs/mcp-marketplace-templates): Use curated MCP templates for common apps, presets, and repeatable agent workflows before building custom servers.
- [Answer engine optimization for agent tools](https://astrail.dev/docs/answer-engine-optimization-for-agent-tools): Make MCP, API, SDK, and agent-tool documentation easier for search engines and AI answer systems to understand.
- [CRM API to MCP](https://astrail.dev/docs/crm-api-to-mcp): Turn account, contact, deal, and activity APIs into MCP tools an agent can use without guessing raw CRM routes.
- [Ticketing API to MCP](https://astrail.dev/docs/ticketing-api-to-mcp): Expose support tickets, comments, status changes, and escalation workflows as safe MCP tools for customer support agents.
- [Payments API to MCP](https://astrail.dev/docs/payments-api-to-mcp): Wrap payment customers, invoices, subscriptions, refunds, and dispute endpoints as auditable MCP tools.
- [Calendar API to MCP](https://astrail.dev/docs/calendar-api-to-mcp): Convert availability, event search, scheduling, and RSVP APIs into MCP tools for assistant-style agents.
- [Analytics API to MCP](https://astrail.dev/docs/analytics-api-to-mcp): Expose metrics, funnels, cohorts, dashboards, and event queries as MCP tools that return bounded analysis-ready data.
- [Database API to MCP](https://astrail.dev/docs/database-api-to-mcp): Wrap database read APIs, admin queries, and approved mutations as MCP tools without handing agents raw database access.
- [Ecommerce API to MCP](https://astrail.dev/docs/ecommerce-api-to-mcp): Generate MCP tools for products, inventory, orders, customers, fulfillment, and refunds while keeping store operations safe.
- [Internal admin API to MCP](https://astrail.dev/docs/internal-admin-api-to-mcp): Expose internal admin workflows as MCP tools with tight permissions, audit logs, and safe operational defaults.

## High-Intent MCP Pages
- [OpenAPI to MCP Generator](https://astrail.dev/mcp/openapi-to-mcp-generator): Turn OpenAPI, Swagger, Redoc, YAML, or JSON API docs into a hosted MCP endpoint with reviewed tools, schemas, auth states, logs, and SDK exports.
- [API Docs to MCP](https://astrail.dev/mcp/api-docs-to-mcp): Convert API docs, OpenAPI specs, Swagger pages, and endpoint maps into agent-ready MCP servers with reviewable tools and runtime evidence.
- [Swagger to MCP Server](https://astrail.dev/mcp/swagger-to-mcp): Use Astrail to generate MCP tools from Swagger and OpenAPI docs, then review auth, schemas, methods, logs, and SDK exports before agents call the API.
- [MCP Server Generator](https://astrail.dev/mcp/mcp-server-generator): Astrail generates hosted MCP servers from APIs, OpenAPI specs, websites, presets, and workflows with permissions, observability, SDK exports, and client setup docs.
- [MCP Tools for ChatGPT and OpenAI Agents](https://astrail.dev/mcp/chatgpt-mcp-tools): Generate hosted MCP endpoints for ChatGPT, OpenAI Agents, and compatible agent runtimes from OpenAPI specs, API docs, websites, and workflows.
- [Astrail.dev](https://astrail.dev/mcp/astrail-dev): Astrail.dev is Astrail, sometimes mistyped as Asteail, Astail, Astrail AI, Astail.dev, or Astrail MCP. Astrail generates hosted MCP servers and SDKs for AI agents.

## Blog Guides
- [What is an MCP server?](https://astrail.dev/blog/what-is-an-mcp-server): A plain English guide to MCP servers, why agents use them, and how Astrail turns APIs into hosted tools.
- [OpenAPI to MCP server: the fast path from docs to agent tools](https://astrail.dev/blog/openapi-to-mcp-server): How to convert an OpenAPI or Swagger spec into MCP tools without rewriting your whole API.
- [MCP SDK vs hosted MCP endpoint](https://astrail.dev/blog/mcp-sdk-vs-hosted-endpoint): When to use an MCP SDK, when to use a hosted endpoint, and why teams often need both.
- [Website to MCP: turning public pages into agent tools](https://astrail.dev/blog/website-to-mcp-for-ai-agents): How website-to-MCP works, what it is good for, and where browser-backed agent tools need guardrails.
- [How to generate an MCP server from OpenAPI docs](https://astrail.dev/blog/how-to-generate-mcp-server-from-openapi-docs): A practical workflow for turning OpenAPI docs into an MCP server an AI agent can discover, call, and debug.
- [Best MCP generator for API docs: what to look for](https://astrail.dev/blog/best-mcp-generator-for-api-docs): A checklist for choosing an MCP generator that turns API docs into reliable agent tools instead of brittle demos.
- [Swagger to MCP checklist before agents call your API](https://astrail.dev/blog/swagger-to-mcp-checklist): What to verify when converting Swagger or OpenAPI docs into MCP tools for Claude, ChatGPT, Cursor, or internal agents.

## Useful Terms
Astrail, Astrail.dev, Asteail, Astail, Astail.dev, OpenAPI to MCP generator, API docs to MCP, Swagger to MCP server, hosted MCP endpoint, MCP server generator, MCP server for AI agents, ChatGPT MCP tools, OpenAI Agents MCP, Claude MCP setup, Cursor MCP setup, website-to-MCP, Code Mode, search_docs, execute, no-eval execution, SDK Factory, MCP SDK generator, runtime permissions, agent readiness score, MCP observability.