Skip to content

idapixl/algora-mcp-server

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Algora MCP Server

An MCP (Model Context Protocol) server that gives AI agents direct access to Algora's open-source bounty platform. Use it from Claude Desktop, Cursor, Windsurf, or any MCP-compatible client to discover, search, and analyze open bounties.

What It Does

AI agents can call five tools:

Tool What It Does
list_bounties Browse open bounties with filters (org, amount, tech)
get_org_bounties Get all bounties for a specific org (cal.com, supabase, etc.)
search_bounties Keyword search across titles, descriptions, repos
get_top_bounties Highest-value open bounties, sorted by reward
get_bounty_stats Aggregate stats: total value, by tech, by org

Requirements

  • Node.js 18+
  • No API key required — Algora's public API is open

Quick Start

git clone https://github.com/idapixl/algora-mcp-server
cd algora-mcp-server
npm install
npm run build

Claude Desktop Config

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "algora": {
      "command": "node",
      "args": ["/absolute/path/to/algora-mcp-server/dist/index.js"]
    }
  }
}

Cursor / Windsurf Config

Add to your MCP settings:

{
  "algora": {
    "command": "node",
    "args": ["/absolute/path/to/algora-mcp-server/dist/index.js"]
  }
}

Example Agent Interactions

Find high-value TypeScript bounties:

"Show me open bounties worth $200+ in TypeScript"

The agent will call get_top_bounties({ tech: "typescript", min_amount: 200 }) and return formatted results.

Check a specific org:

"What bounties does projectdiscovery have open?"

Calls get_org_bounties({ org: "projectdiscovery" }).

Search by domain:

"Find bounties related to MCP or model context protocol"

Calls search_bounties({ keyword: "MCP" }).

Market overview:

"What's the total value of all open bounties on Algora?"

Calls get_bounty_stats({}) and returns counts, total, average, breakdown by tech and org.

Tool Reference

list_bounties

Parameter Type Default Description
org string Org slug (e.g., "cal", "supabase")
status "open" | "completed" | "all" "open" Bounty status
limit number 20 Results per page (1–100)
cursor string Pagination cursor
min_amount number Minimum USD amount
max_amount number Maximum USD amount
tech string Tech filter (e.g., "typescript")

get_org_bounties

Parameter Type Required Description
org string Yes Org slug from Algora URL
status string No Default: "open"
limit number No Default: 50

search_bounties

Parameter Type Required Description
keyword string Yes Search term
tech string No Tech stack filter
min_amount number No Min USD
limit number No Default: 30

get_top_bounties

Parameter Type Default Description
tech string Tech filter
min_amount number 100 Min USD
limit number 10 How many to return

get_bounty_stats

Parameter Type Description
org string Scope to org. Omit for all.

Development

npm run dev      # Run with tsx (no build step)
npm run build    # Compile TypeScript
npm run typecheck  # Type check without emitting

Architecture

The server uses stdio transport (standard MCP convention) — no HTTP server, no port, no configuration. It communicates with the MCP client through stdin/stdout and connects to Algora's public API (no auth required).

The @algora/sdk tRPC client handles API calls. Local filtering is applied in-memory for features the API doesn't natively support (keyword search, min/max amount).

License

MIT

About

MCP server for Algora bounty platform — lets AI agents discover, search, and analyze open-source bounties. 5 tools, no API key needed.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors