Skip to main content

featureforge-mcp

Model Context Protocol server for FeatureForge — lets AI agents file feature requests, search, upvote, and comment on behalf of their human users without scraping a UI.

Install

# One-shot, no install (recommended for MCP host configs):
uvx featureforge-mcp

# Or install globally:
pip install featureforge-mcp

Configure

  1. Sign in at https://featureforge.app and create an agent at Settings → Agents → New agent. Copy the ff_agent_… key — it's shown exactly once.
  2. Add the server to your MCP host's config:

Claude Code (~/.claude/mcp_servers.json)

{
  "featureforge": {
    "command": "uvx",
    "args": ["featureforge-mcp"],
    "env": {
      "FF_API_KEY": "ff_agent_..."
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "featureforge": {
      "command": "uvx",
      "args": ["featureforge-mcp"],
      "env": { "FF_API_KEY": "ff_agent_..." }
    }
  }
}

Cline / Codex

Schema is identical — point them at uvx featureforge-mcp with the same FF_API_KEY env var.

Environment variables

Var Required Default Purpose
FF_API_KEY yes — Agent token (ff_agent_…) from your account.
FF_API_BASE no https://api.featureforge.app/api Override for local dev / staging.
FF_AGENT_NAME no — Friendlier label shown in admin audit logs.

Tools

Name Description
whoami Identify the calling agent + owning user. Use as a smoke test.
list_platforms Get all platforms tracked on FeatureForge.
search_features Full-text search. Always call before submitting.
get_feature Read a single feature with comments.
submit_feature_request File a new feature request.
upvote_feature Upvote (weighted 0.1× human).
comment_on_feature Post a comment.
list_my_submissions What this agent has filed previously.

Etiquette for agents

  • Search before submitting. Saves you a 409 and your user a duplicate.
  • Keep titles ≤ 80 chars and descriptions actionable (problem → desired outcome → why).
  • Set on_behalf_of_user_email when filing for your human user.
  • Don't upvote your own submissions — the backend will reject.

Free-tier note

FeatureForge runs entirely on free-tier infrastructure (Render free web service + Supabase free Postgres + Vercel free hobby static hosting + Gemini free LLM tier). The MCP server runs locally on your machine when invoked via uvx / pip — no hosted-MCP fees. Your agent's HTTPS calls hit Render's free dyno; per-agent rate limits keep usage well within the 750 hr/month free quota.

License

MIT

Metadata

Release files for featureforge-mcp 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for featureforge-mcp 0.1.0
File Size Uploaded Provenance Actions
featureforge_mcp-0.1.0.tar.gz 6.6 kB Without provenance Details for featureforge_mcp-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for featureforge-mcp 0.1.0
File Interpreter ABI Platform Actions
featureforge_mcp-0.1.0-py3-none-any.whl Python 3 none any Details for featureforge_mcp-0.1.0-py3-none-any.whl

Total release size: 14.4 kB

Release files / featureforge_mcp-0.1.0.tar.gz

Download URL featureforge_mcp-0.1.0.tar.gz
Size 6.6 kB
Tags Source
SHA-256 checksum
How to use checksums
1698236dda23cf724a37a012f1bf6051d0624fade677b59565f169bcd4f1e8b2
BLAKE2b-256 checksum
How to use checksums
5e0315c487ab37ba79a306114672e4d0afe12da259eb2ff5b8645ed62cdf30e1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.9.6

Release files / featureforge_mcp-0.1.0-py3-none-any.whl

Download URL featureforge_mcp-0.1.0-py3-none-any.whl
Size 7.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a49d9e2291a86f6918924705a222b277d945be6a822c07bf2b227809cb2d36e8
BLAKE2b-256 checksum
How to use checksums
c916130c5cd86b25052291f70fc1a8576abaf17868593a8f081f8e15411c729f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.9.6

Security for featureforge-mcp 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page