Agents & LLMs

The Stocksmith API is built to be consumed by automation and AI agents.

MCP server

Stocksmith exposes the same read-only capabilities as a hosted MCP server using the Streamable HTTP transport:

https://api.stocksmith.io/mcp

Authenticate with the same Bearer API key you use for the REST API (see Authentication). The server exposes read-only tools that mirror the REST endpoints — ping, get_account, plus list_* / get_* for materials, products, components, recipes, manufactures, and expenses. The same rate limits apply.

Example client configuration:

{
  "mcpServers": {
    "stocksmith": {
      "type": "http",
      "url": "https://api.stocksmith.io/mcp",
      "headers": { "Authorization": "Bearer live_your_key_here" }
    }
  }
}

llms.txt

This site publishes an /llms.txt (and /llms-full.txt) — a compact, LLM-friendly index of the documentation. Point your agent or retrieval pipeline at it to give the model accurate, current context about the API.

Tips for agents

• Authenticate with a Bearer token (see Authentication).
• Respect pagination — iterate using the meta envelope (see Pagination).
• Handle 429 with Retry-After backoff (see Rate Limiting).
• Treat the machine-readable OpenAPI schema as the contract.