{icon &&

{color ?

}

{isInlineTag ?

{title} {tag && {tag}}

{title}

}

{children}

{tag && !isInlineTag &&

{tag}

} {linkText &&

{linkHref ? {linkText} : {linkText} }

}

; return href ? {card} : card; }; Building with AI hero

Grid's documentation, OpenAPI spec, and CLI are designed to work with AI coding assistants like Claude Code, Cursor, and Codex. Whether you're exploring the API for the first time or building a production integration, AI tools can help you move faster. ## What AI assistants can do with Grid Ask questions about endpoints, request/response schemas, supported currencies, and payment rails Use the Grid Skill to create customers, manage accounts, get quotes, and send payments directly from your AI assistant Get step-by-step guidance for multi-step flows like international payouts, on/off-ramps, and KYC onboarding Troubleshoot error codes, validate account details, and diagnose failed transactions ## AI-accessible documentation These Grid docs are automatically available to LLMs and AI tools in machine-readable formats — no configuration needed. ### llms.txt Grid docs generate [llms.txt](https://llmstxt.org/) files that give AI tools a structured index of all documentation: * [`/llms.txt`](/llms.txt) — Concise index of all pages with titles and descriptions * [`/llms-full.txt`](/llms-full.txt) — Complete documentation content in a single file These are generated automatically and always up to date. Use `llms-full.txt` when you want to give an AI assistant full context about the Grid API in one shot. ### Markdown export Each page in the Grid docs is automatically available as a Markdown file simply by adding `.md` to the end of the URL. For example, the [Building with AI](/platform-overview/building-with-ai) page is available as [`/platform-overview/building-with-ai.md`](/platform-overview/building-with-ai.md). You can also copy any page's content as Markdown with the keyboard shortcut Command + C (Ctrl + C on Windows) and paste it directly into ChatGPT, Claude, or any AI assistant for context-aware help with your specific question. ## Install the Grid API agent skill The Grid API skill gives [Claude Code](https://docs.anthropic.com/en/docs/claude-code) or another Skill-compatible agent full access to the Grid API via a built-in CLI. Install it with: ```bash theme={null} npx skills add lightsparkdev/grid-api ``` Make sure to install it for whichever agent you're using. For example, if you're using Claude Code, you'll need to explicitly select Claude Code in the agent installation selection screen. Once installed, you can start asking questions immediately. To execute API operations, you'll need to configure your credentials. ### Configure your credentials To set your grid credentials, simply ask the agent to help you configure them: ``` Help me configure my Grid API credentials. ``` It'll prompt you for your API Token ID and Client Secret, validate them, and save to `~/.grid-credentials` for future use. Start in the sandbox environment to experiment safely. The Skill is great at generating fake account data to help you test different flows. ## MCP server Grid provides a [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server that gives AI agents access to Grid's documentation, so your agentic workflows have full context of the Grid API during implementation. ``` https://grid.lightspark.com/mcp ``` The MCP server exposes two tools: * **`search_grid_api_documentation`** — Search the Grid docs for relevant guides, code examples, and API references * **`get_page_grid_api_documentation`** — Retrieve the full content of a specific documentation page The MCP server provides documentation access to support agentic implementation workflows. It does not yet support interacting with the Grid API directly — use the [Grid API agent skill](#install-the-grid-api-agent-skill) or direct API calls for that. Add it to any MCP-compatible client (Claude Desktop, Cursor, Windsurf, etc.) using the streamable HTTP transport: ```json theme={null} { "mcpServers": { "grid-api-docs": { "url": "https://grid.lightspark.com/mcp" } } } ``` ## Example prompts Try these prompts in Claude Code or paste them into your AI assistant of choice: ### Getting started ``` What currencies does Grid support? Show me the coverage by country. ``` ``` Walk me through the steps to send a payout from USD to MXN via CLABE. ``` ### Payouts ``` Create an external account for a bank in Mexico using CLABE, then create a quote to send $500 USD and show me the exchange rate before executing. ``` ``` Send $100 to $alice@example.com via UMA. Show me the exchange rate first. ``` ### On/off-ramps ``` Help me set up a fiat-to-crypto on-ramp. I want to convert USD to BTC using a Spark wallet. ``` ``` I need to off-ramp USDC to a US bank account. Walk me through the full flow. ``` ### Account management ``` List all my customers and their KYC status in a table. ``` ``` Create a new individual customer and generate a KYC onboarding link. ``` ### Debugging ``` I'm getting QUOTE_EXPIRED errors. What's happening and how do I fix it? ``` ``` My external account creation is failing for a Nigerian bank account. What fields am I missing? ``` ## Tips for best results 1. **Be specific about your use case** — "Send a payout to Brazil via PIX" gets better results than "help me send money" 2. **Start with the sandbox** — Ask the AI to use sandbox mode so you can experiment without real funds 3. **Give context** — Paste the relevant docs page or point the AI to `/llms-full.txt` for full API context 4. **Iterate on errors** — If an API call fails, paste the error and ask the AI to diagnose it