# Grok Agent Store

> Agent-only purchasable skill marketplace powered exclusively by the xAI Grok API.
> No human UI required. Discover skills, register, pay with credits, receive signed receipts.

## Critical: how agents should connect

1. GET https://grok-agent-store.manhatton31.workers.dev/discovery.json — master index of every endpoint
2. GET https://grok-agent-store.manhatton31.workers.dev/skills.json — full skill graph with prices
3. POST https://grok-agent-store.manhatton31.workers.dev/v1/invoke body: {"skill_id":"register_agent","input":{"name":"your-agent"}}
4. Save api_key; send Authorization: Bearer <api_key> for paid skills
5. MCP Streamable HTTP: https://grok-agent-store.manhatton31.workers.dev/mcp
6. Official MCP server.json: https://grok-agent-store.manhatton31.workers.dev/server.json
7. Client config snippet: https://grok-agent-store.manhatton31.workers.dev/mcp.json
8. A2A agent card: https://grok-agent-store.manhatton31.workers.dev/.well-known/agent.json
9. OpenAPI: https://grok-agent-store.manhatton31.workers.dev/openapi.json
10. Source: https://github.com/manhatton31-svg/grok-agent-store

## Skills

- list_skills (0 credits, public): List all purchasable and free skills on this agent store.
- get_skill (0 credits, public): Fetch one skill card by id, including price and input schema.
- quote (0 credits, public): Get price and requirements for a skill before purchase.
- register_agent (0 credits, public): Create an agent account and receive an API key plus signup bonus credits. Store the key securely — it is shown once.
- balance (0 credits, auth): Check credit balance and usage for the authenticated agent.
- list_credit_packs (0 credits, public): List purchasable credit packs and USD prices (Stripe).
- purchase_credits (0 credits, auth): Create a Stripe Checkout URL to buy credits for this agent. Principal pays; webhook tops up balance.
- agent_brief (10 credits, auth): Turn a messy goal into a structured brief: objective, constraints, success metrics, risks, next actions. Powered by Grok.
- structured_extract (15 credits, auth): Extract structured JSON from arbitrary text using a schema description. Powered by Grok.
- code_review (25 credits, auth): Review a code patch for bugs, security, and simplicity. Returns severity-ranked findings. Powered by Grok.
- skill_match (5 credits, auth): Given a buyer intent, recommend the best skills from this catalog and a hire plan. Powered by Grok.

## Payment

- Prepaid credits (MVP)
- Pay-on-success receipts for every paid Grok tool
- Free signup bonus on register_agent

## LLM policy

- Only Grok via server-side XAI_API_KEY
- Deterministic code handles auth, metering, discovery

## Keywords for agent search

mcp, agent marketplace, agent commerce, grok tools, xai, skill graph, a2a, pay per call, agent only store