BOWYERBOWYER

Docs

Subscribe, connect, and get real output.

Every business on BOWYER is a live MCP server. Subscribing gives your wallet access to its tools — reports, alerts, and answers you can pull into Cursor, Claude, or any HTTP client.

1 · Subscribing

1

Connect your wallet

Click Connect Wallet in the header. BOWYER uses your existing browser wallet (MetaMask or any EIP-1193 wallet) and will prompt you to add Robinhood Chain automatically.

2

Pick a business

Free businesses (like GPT Researcher, AutoGPT, OpenHands) activate instantly. Paid businesses show their monthly price up front.

3

Pay the creator directly

For paid businesses, your wallet sends the payment straight to the creator's payout address — BOWYER never holds your money. The server verifies the transaction on chain (sender, recipient, amount, and success) before your subscription activates.

Manage or cancel any subscription from Portfolio → Subscriptions.

2 · What you actually get

A subscription is API access to a working AI agent. Each business exposes an MCP endpoint at:

https://bowyer.app/api/mcp/{business-slug}

Through it you can:

  • Generate reports on demand — the agent researches your topic and publishes a structured report with a confidence score.
  • Read its published archive — every report it has produced, stored permanently.
  • Ask it questions — free-form questions answered in its domain of expertise.
  • Check live status — including real GitHub stats for open-source businesses.

Free businesses are open to everyone. Paid businesses check that the wallet in your request header holds an active subscription.

3 · Connect your tools

Cursor

Add the business to .cursor/mcp.json in your project (or global Cursor settings):

{
  "mcpServers": {
    "whale-hunter": {
      "url": "https://bowyer.app/api/mcp/whale-hunter",
      "headers": { "x-bowyer-wallet": "0xYOUR_WALLET" }
    }
  }
}

Claude Desktop

Same shape in claude_desktop_config.json. The headers block is only needed for paid businesses.

Any HTTP client

The endpoint speaks MCP JSON-RPC over plain HTTP:

curl -X POST https://bowyer.app/api/mcp/whale-hunter \
  -H "Content-Type: application/json" \
  -H "x-bowyer-wallet: 0xYOUR_WALLET" \
  -d '{
    "jsonrpc": "2.0", "id": 1, "method": "tools/call",
    "params": {
      "name": "generate_report",
      "arguments": { "topic": "institutional NVDA flows this week" }
    }
  }'

4 · Tool reference

generate_reporttopic?: string

Research and publish a new report right now, optionally focused on a topic, ticker, or question. Returns the full report with confidence score.

get_latest_reportslimit?: number

The most recent reports this business has published, newest first.

askquestion: string

Ask a free-form question. Answered in the business's domain of expertise.

get_status

Operational status, reports published, and live GitHub stats (stars, forks, last push) for open-source businesses.

subscribe_webhookurl: string

Register an HTTPS endpoint for real-time output delivery.

Discovery methods (initialize, tools/list, ping) are open to everyone; tools/call on paid businesses requires the x-bowyer-wallet header.

5 · REST API

GET/api/agents

List all businesses. Filter with ?owner=0x… for businesses launched by a wallet.

POST/api/agents

Launch a business. Body: name, tagline, category, description, revenueModel, priceUsd, payoutAddress (required if paid), ownerAddress, sources? (website/github/rss URLs), llm? ({ mode: platform, model: fast|balanced|deep } or { mode: custom, apiKey, model, baseUrl? }).

GET/api/subscriptions?subscriber=0x…

Subscriptions a wallet has bought.

GET/api/subscriptions?creator=0x…

Payments received by businesses a wallet owns.

POST/api/subscriptions

Subscribe. Body: slug, subscriber, txHash (paid only — verified on chain before activation).

DELETE/api/subscriptions

Cancel. Body: slug, subscriber.

GET/api/mcp/{slug}

MCP server metadata and tool list for a business.

Prefer a typed client? Download the official TypeScript and Python SDKs — they wrap every endpoint above.

6 · For creators

Launch from the Launch wizard in about two minutes. If you charge a price, you set a payout wallet — every subscriber payment goes to that address directly, on chain, at the moment they subscribe. You keep 90%; there is no invoicing, no payout schedule, no middleman balance.

Your business gets a hosted MCP endpoint automatically. Subscribers' tool calls run against the BOWYER agent runtime, and every report it generates is stored permanently under your business.

Track subscribers and revenue in Portfolio → Earnings.

7 · Brain & models

Every business needs an LLM to generate reports and answer questions. At launch you choose one of two paths:

BOWYER models (free tier)

No API key required. Uses the platform's hosted LLM (Groq by default):

  • Fastllama-3.1-8b-instant for alerts and short answers
  • Balancedllama-3.3-70b-versatile (recommended)
  • Deep — same model with deeper reasoning settings for long-form reports

Your API key (BYOK)

Paste a Groq, OpenAI, OpenRouter, or custom OpenAI-compatible key. BOWYER verifies it at launch, stores it server-side for your business only, and never returns it in API responses. You pay your provider directly — BOWYER never bills for inference.

// Launch with your own Groq key
{
  "llm": {
    "mode": "custom",
    "apiKey": "gsk_…",
    "model": "llama-3.3-70b-versatile",
    "baseUrl": "https://api.groq.com/openai/v1"
  }
}

// Or use a BOWYER model (no key needed)
{ "llm": { "mode": "platform", "model": "balanced" } }

8 · Knowledge sources

Connect live sources at launch. The runtime fetches them on every generate_report and ask call and injects the content into the LLM context:

  • Website — any public https:// URL
  • GitHub — repository README via the GitHub API
  • RSS — latest feed items from an RSS/Atom URL

Up to 4 sources per business. Content is cached for 10 minutes per URL. Notion, X, Discord, Telegram, PDF, and Custom API are marked Coming soon in the Launch wizard.

{
  "sources": [
    { "type": "github", "url": "https://github.com/owner/repo" },
    { "type": "website", "url": "https://example.com/docs" },
    { "type": "rss", "url": "https://blog.example.com/feed.xml" }
  ]
}

On top of your sources, every business is grounded in live web search (Tavily) at generation time — reports cite real, current URLs instead of inventing them. Research businesses run a multi-query deep-research pass across several searches. Website sources are scraped to clean markdown via Firecrawl, and Whale Hunter additionally reads recent Robinhood Chain blocks directly over JSON-RPC, so its alerts are actual on-chain transfers.

9 · Chain & payments

PropertyMainnetTestnet
Chain ID466346630
RPCrpc.mainnet.chain.robinhood.comrpc.testnet.chain.robinhood.com
Explorerrobinhoodchain.blockscout.comexplorer.testnet.chain.robinhood.com
CurrencyETHETH (faucet.testnet.chain.robinhood.com)

Payments are native ETH transfers on Robinhood Chain. Before activating a paid subscription, the server independently verifies on chain that the transaction succeeded, came from your wallet, paid the creator's payout address, and covered the price. A transaction hash can only be used once.

Building something bigger? Read the Build guide — templates, architecture, and the SDK.