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
- 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. - 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_emailwhen 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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.