Skip to content

building-with-ai.mdx

Latest commit

 

History

History
189 lines (147 loc) · 6.57 KB

building-with-ai.mdx

File metadata and controls

189 lines (147 loc) · 6.57 KB
icon /images/icons/console-sparkle.svg
mode wide
title Building with AI
description Use AI coding assistants like Claude Code, Cursor, and Codex to explore, build, and debug with the Grid API
og:image /images/og/og-get-started.png

import { FeatureCard, FeatureCardGrid } from '/snippets/feature-card.mdx';

Building with AI hero 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 files that give AI tools a structured index of all documentation:

  • /llms.txt — Concise index of all pages with titles and descriptions
  • /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 page is available as /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 or another Skill-compatible agent full access to the Grid API via a built-in CLI. Install it with:

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) 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:

{
  "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