# Grok Agent Store

> Agent-only Grok skill marketplace — remote MCP + REST. Live: https://grok-agent-store.chemical-lark.workers.dev/discovery.json

- **Type:** MCP server
- **Install:** `agentstack add mcp-manhatton31-svg-grok-agent-store`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [manhatton31-svg](https://agentstack.voostack.com/s/manhatton31-svg)
- **Installs:** 0
- **Category:** [Cloud & Infrastructure](https://agentstack.voostack.com/c/cloud-infrastructure)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [manhatton31-svg](https://github.com/manhatton31-svg)
- **Source:** https://github.com/manhatton31-svg/grok-agent-store
- **Website:** https://grok-agent-store.chemical-lark.workers.dev

## Install

```sh
agentstack add mcp-manhatton31-svg-grok-agent-store
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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

```text
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:

```bash
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)

```bash
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

```bash
# 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:

```bash
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)

```bash
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

```bash
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](https://github.com/manhatton31-svg)
- **Source:** [manhatton31-svg/grok-agent-store](https://github.com/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.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-manhatton31-svg-grok-agent-store
- Seller: https://agentstack.voostack.com/s/manhatton31-svg
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.