Getting Started

AI Context

Machine-readable TokPortal API context for ChatGPT, Claude, Cursor, MCP clients, and internal agent workflows.

AI Context

TokPortal publishes machine-readable context files so AI tools can understand the API without scraping the site.

Canonical AI Assets

AssetURLUse
llms.txtdevelopers.tokportal.com/llms.txtShort index for LLM discovery
llms-full.txtdevelopers.tokportal.com/llms-full.txtFull docs corpus for ChatGPT, Claude, Cursor, and agent ingestion
ai-context.jsondevelopers.tokportal.com/ai-context.jsonStructured product, auth, SDK, MCP, docs, and operation metadata
developer-ecosystem.jsondevelopers.tokportal.com/developer-ecosystem.jsonPackage manager, release status, and SDK distribution metadata
package-release-manifest.jsondevelopers.tokportal.com/package-release-manifest.jsonSource paths, build commands, publish commands, and release status for generated SDK/CLI/MCP packages
openapi.jsondevelopers.tokportal.com/openapi.jsonOpenAPI 3.1 schema for code generation
openapi.yamldevelopers.tokportal.com/openapi.yamlYAML OpenAPI schema for tools that prefer YAML

Use this when starting a coding session with an AI assistant:

Read https://developers.tokportal.com/llms-full.txt and answer using only the TokPortal API docs.
If you need machine-readable package, endpoint, or MCP metadata, read https://developers.tokportal.com/ai-context.json.

Use this when generating code:

Use the TokPortal OpenAPI schema at https://developers.tokportal.com/openapi.json.
Use the public Node SDK, CLI, MCP server, or raw OpenAPI depending on the integration surface.
Use X-API-Key authentication with keys formatted as sk_ plus 64 lowercase hex characters.

What ai-context.json Contains

  • Canonical docs and API URLs.
  • Authentication rules and API key format.
  • Mental model: Profiles, Bundles, Accounts, Posts.
  • SDK, CLI, and MCP package metadata from the TokPortal developer ecosystem.
  • Release metadata for generated package source and package-manager publishing.
  • Deferred SDK policy for Ruby, Java, PHP, .NET, and Rust.
  • Public OpenAPI operations with method, route, operation ID, summary, and tags.
  • AI docs features: Copy for AI, TokPortal AI chat, and llms-full.txt.

Human Workflow

Every docs page includes Copy for AI. Use it to copy the current page with source URL and product context into ChatGPT, Claude, or Cursor.

The docs also include Ask TokPortal AI. It opens a right-side chat drawer, streams answers in real time, and grounds responses in the current page plus the generated llms-full.txt corpus.