English Français العربية

io.github.vncent786/bounty-api

Official registry E-commerce

Singapore property & financial data APIs for AI agents. 27 MCP tools. x402 micropayments.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http bounty-api 'https://bountyapi.com/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "bounty-api": {
            "type": "http",
            "url": "https://bountyapi.com/mcp"
        }
    }
}
NPM package bountyapi-mcp
Claude Code 
claude mcp add bounty-api -e 'EVM_PRIVATE_KEY=<your evm_private_key>' -- npx -y bountyapi-mcp@1.8.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "bounty-api": {
            "command": "npx",
            "args": [
                "-y",
                "bountyapi-mcp@1.8.0"
            ],
            "env": {
                "EVM_PRIVATE_KEY": "<your evm_private_key>"
            }
        }
    }
}

Environment variables

  • EVM_PRIVATE_KEY secret Optional. EVM private key to enable auto-pay for paid endpoints via x402. Without it, only the 8 free endpoints are callable; paid endpoints return a 402 payment challenge. Never required to use the free tier.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Bounty
  2. Read this first
  3. Quickstart
  4. What this repo is NOT
  5. Layout

Bounty

A research system that turns online conversations into cited findings. Bounty collects posts, comments, and replies from YouTube, Reddit, TikTok, Instagram, and X; discovers rising topics via Google Trends; and uses LLM analysis to extract signals — pain points, adoption patterns, objections, belief shifts — each backed by quotes and source links. If evidence is thin, it says so.

Users: investors (unknown-unknown discovery, pain-point research around companies), marketers (creative angles, competitor mentions), product teams (feature gaps, user complaints). The engine is horizontal; investing is the first lens, not a hardwired filter.

Live at bountyapi.com/dashboard (token-gated).

Read this first

  1. AGENTS.md — operating manual: architecture, the two-pipeline warning, commands, deploy flow, credentials map, hard rules, known-broken list. Any agent (or human) working in this repo must read this before making changes.
  2. STATE.md — product philosophy, what's built, gaps, priority order.

Quickstart

python -m pytest tests/ -x -q          # 189+ tests, must be green before every push
python -m uvicorn app:app --port 8000  # local dev; BOUNTY_ENV=development bypasses token gate
# open http://localhost:8000/dashboard

Deploy: push to main → Railway auto-builds → bountyapi.com. Nothing else.

What this repo is NOT

  • Not the x402/USDC data-API marketplace — that code exists but is deferred (see docs/legacy/)
  • Not Singapore property/real-estate tooling — legacy, deferred
  • Not an MCP directory play — legacy, deferred

Old strategy and marketing documents live in docs/legacy/ and describe that earlier direction. They are kept for history only.

Layout

PathWhat
apis/FastAPI routers (dashboard API, dashboard page, social search)
public/Dashboard frontend (vanilla JS/CSS)
social_scraper/Connectors, broker, discovery pipeline, monitoring, storage, LLM client
tests/Full suite
docs/legacy/Superseded strategy docs — do not implement from these

Frequently asked questions

What is io.github.vncent786/bounty-api?

Singapore property & financial data APIs for AI agents. 27 MCP tools. x402 micropayments.

How do I install io.github.vncent786/bounty-api?

It runs as a remote server. In Claude Code: claude mcp add --transport http bounty-api 'https://bountyapi.com/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.vncent786/bounty-api need an API key?

Yes. It expects EVM_PRIVATE_KEY, which you set in its configuration.

Is io.github.vncent786/bounty-api open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.vncent786/bounty-api?

It is published by vncent786. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.