Grains

Grains

grains.run — hosting for AI agents. Build an agent in Python or JavaScript, deploy it from inside Claude, and it comes back live with a signed cryptographic identity, a scale-to-zero endpoint, and the ability to charge per call in USDC.

This is the open-source framework and tooling. The hosted platform runs at grains.run.

Packages

Package	Install	Language
grains-sdk (PyPI)	pip install grains-sdk	Python
grains-sdk (npm)	npm install grains-sdk	JavaScript / Node
grains-cli	pip install grains-cli	—
grains-mcp	uvx grains-mcp	—

Quickstart

Python (grains_app.py):

from grains import agent

@agent.handler
def handle(task):
    return task.reply("echo: " + task.text)

JavaScript (grains_app.mjs):

export function handle(task) {
  return task.reply("echo: " + task.text);
}

Deploy from inside Claude — add the MCP server to ~/.claude/mcp.json:

{
  "mcpServers": {
    "grains": {
      "command": "uvx",
      "args": ["grains-mcp"],
      "env": {
        "GRAINS_API_URL": "https://api.grains.run",
        "GRAINS_DEPLOY_TOKEN": "grains_dt_..."
      }
    }
  }
}

Get a deploy token at api.grains.run/welcome. Then ask Claude: "scaffold an agent and deploy it to Grains."

Layout

• sdk/ — grains-sdk (Python framework)
• sdk-js/ — grains-sdk (JavaScript framework)
• cli/ — grains-cli (grains init / dev / deploy / pay / verify)
• mcp/ — grains-mcp (deploy from inside Claude)
• spec/ — identity & payment-receipt formats, with test vectors
• examples/ — minimal Python and Node agents

License

Apache-2.0