Grok Agent Store

Grok Agent Store

Agent-only vertical skill marketplace powered exclusively by the xAI Grok API.

Buyer agents discover skills, register for credits, invoke Grok-backed tools, and receive signed receipts. Humans set the operator secrets; agents do the commerce.

🤖 Agent: start here

Master index: https://grok-agent-store.manhatton31.workers.dev/discovery.json

MCP:     https://grok-agent-store.manhatton31.workers.dev/mcp
Skills:  https://grok-agent-store.manhatton31.workers.dev/skills.json
Card:    https://grok-agent-store.manhatton31.workers.dev/.well-known/agent.json
llms:    https://grok-agent-store.manhatton31.workers.dev/llms.txt
server:  https://grok-agent-store.manhatton31.workers.dev/server.json

First call:

curl -s https://grok-agent-store.manhatton31.workers.dev/v1/invoke \
  -H "content-type: application/json" \
  -d '{"skill_id":"register_agent","input":{"name":"my-buyer"}}'

What agents get

| Endpoint | Purpose | |---|---| | GET /discovery.json | Master discovery index | | GET /skills.json | Skill graph (prices, schemas) | | GET /.well-known/agent.json | A2A-style agent card | | GET /server.json | Official MCP Registry format | | GET /mcp.json | Client config snippet | | GET /openapi.json | OpenAPI 3.1 | | GET /llms.txt / /ai.txt / /AGENTS.md | Machine instructions | | GET /robots.txt / /sitemap.xml | Crawler surfaces | | POST /v1/invoke | REST skill invoke | | POST /mcp | MCP Streamable HTTP |

Skills (MVP)

| Skill | Credits | Auth | |---|---:|---| | list_skills / get_skill / quote | 0 | No | | register_agent | 0 (+ bonus) | No | | balance | 0 | Yes | | skill_match | 5 | Yes | | agent_brief | 10 | Yes | | structured_extract | 15 | Yes | | code_review | 25 | Yes |

Quickstart (local)

cd grok-agent-store
npm install
# put your key in .dev.vars (gitignored pattern below)
npx wrangler dev

.dev.vars:

XAI_API_KEY=xai-...
PUBLIC_BASE_URL=http://127.0.0.1:8787
GROK_MODEL=grok-4
SIGNUP_BONUS_CREDITS=100

Agent flow

# 1) Register
curl -s http://127.0.0.1:8787/v1/invoke \
  -H "content-type: application/json" \
  -d '{"skill_id":"register_agent","input":{"name":"demo-buyer"}}'

# 2) Use a paid skill (paste api_key)
curl -s http://127.0.0.1:8787/v1/invoke \
  -H "content-type: application/json" \
  -H "Authorization: Bearer gas_..." \
  -d '{"skill_id":"agent_brief","input":{"goal":"Launch an agent marketplace"}}'

MCP clients

Point Streamable HTTP MCP at https:///mcp and send:

Authorization: Bearer gas_...

Live deploy (current)

Public base: https://grok-agent-store.manhatton31.workers.dev

| Surface | URL | |---|---| | Skill graph | https://grok-agent-store.manhatton31.workers.dev/skills.json | | Agent card | https://grok-agent-store.manhatton31.workers.dev/.well-known/agent.json | | OpenAPI | https://grok-agent-store.manhatton31.workers.dev/openapi.json | | llms.txt | https://grok-agent-store.manhatton31.workers.dev/llms.txt | | REST invoke | POST https://grok-agent-store.manhatton31.workers.dev/v1/invoke | | MCP | https://grok-agent-store.manhatton31.workers.dev/mcp |

This was launched with wrangler deploy --temporary (preview account). Claim the account within 60 minutes or the deploy can expire:

https://dash.cloudflare.com/claim-preview?claimToken=6ByjulVj7W-mC6i6KWid0OqyEomj8Wt5lZoUDSbWI1s

Required operator step: Grok secret

Paid skills need your xAI key:

npx wrangler secret put XAI_API_KEY --temporary
# paste key from https://console.x.ai

Until this is set, /health shows "grok_configured": false and Grok tools return an error.

Deploy (Cloudflare Workers, permanent)

npx wrangler login
npx wrangler kv namespace create STORE
# paste id into wrangler.jsonc
npx wrangler secret put XAI_API_KEY
# set PUBLIC_BASE_URL in wrangler.jsonc to your workers.dev URL
npx wrangler deploy

After deploy, agents find you via:

• https://.workers.dev/skills.json
• https://.workers.dev/.well-known/agent.json
• https://.workers.dev/llms.txt
• MCP: https://.workers.dev/mcp

Optional: custom domain

npx wrangler domains add your-domain.com

Update PUBLIC_BASE_URL to the custom domain.

Architecture

• Code — auth, metering, discovery, receipts (deterministic, free)
• Grok — only LLM for paid skills (api.x.ai)
• KV — agent balances + receipts
• Durable Object — MCP session state (GrokAgentStore)

Roadmap

1. ~~Vertical MCP + credits + discovery~~ (this MVP)
2. x402 pay-per-call without prepaid accounts
3. Job marketplace (hire multi-step workflows with escrow)
4. Seller-listed third-party skills

License

MIT

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: manhatton31-svg
• Source: manhatton31-svg/grok-agent-store
• License: MIT
• Homepage: https://grok-agent-store.chemical-lark.workers.dev

Install and usage instructions live in the source repository linked above.