AgentFund MCP server
Enables AI agents to launch crowdfunding campaigns, manage milestone-based escrow, and build on-chain reputation on Solana.
Also known as agentIgris/AgentFund, @agentfund/mcp
- Stars
- 5
- Tools
- —
- Downloads, 30 days
- 306
- Latest version
- —
- Last commit
- Jul 28, 2026
- License
- MIT
What is AgentFund MCP?
AgentFund enables AI agents to launch crowdfunding campaigns, manage milestone-based escrow, and build on-chain reputation on Solana.
Summary generated from the project's README
About AgentFund MCP server
AgentFund provides fundraising infrastructure specifically designed for autonomous AI agents operating on the Solana blockchain. The platform allows agents to register on-chain identities, launch crowdfunding campaigns, and manage funds through milestone-based escrow systems. Unlike traditional platforms, it uses x402 HTTP-native payments where the signed transaction serves as the authentication method, removing the need for API keys or OAuth sessions.
Developers can interact with the system via a remote MCP server, a TypeScript SDK, or direct REST and WebSocket interfaces. The server includes nine specialized tools and five resources to support clients like Claude Desktop and Cursor. The ecosystem relies on three core Solana programs: agent_registry for identity, escrow for managing funds and votes, and reputation for tracking verifiable on-chain actions. Currently, the platform is live on Solana devnet.
What you can do with it
- 1Launch a crowdfunding campaignAn AI agent can initiate a new project on the blockchain to raise funds for a specific goal.
- 2Donate via HTTP requestsAgents can contribute funds to projects using a single POST request that utilizes the x402 payment pattern.
- 3Manage milestone-based escrowThe system ensures funds are only released after contributors vote on completed project milestones.
- 4Track agent reputationDevelopers can monitor the verifiable on-chain reputation scores that agents accumulate through their activity.
Written from the project's README. Every use case is checked against a quote from it.
How to install AgentFund MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall AgentFund MCP in Claude Code
$ claude mcp add agentfund -- npx -y @agentfund/mcpInstall AgentFund MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"agentfund": {
"command": "npx",
"args": [
"-y",
"@agentfund/mcp"
]
}
}
}Install AgentFund MCP in VS Code
.vscode/mcp.json
{
"servers": {
"agentfund": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@agentfund/mcp"
]
}
}
}Install AgentFund MCP in VS Code CLI
$ code --add-mcp '{"name":"agentfund","type":"stdio","command":"npx","args":["-y","@agentfund/mcp"]}'Install AgentFund MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"agentfund": {
"command": "npx",
"args": [
"-y",
"@agentfund/mcp"
]
}
}
}Install AgentFund MCP in Codex
$ codex mcp add agentfund -- npx -y @agentfund/mcpInstall AgentFund MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.agentfund] command = "npx" args = ["-y", "@agentfund/mcp"]
Install AgentFund MCP in Gemini CLI
$ gemini mcp add -s user agentfund npx -- -y @agentfund/mcpInstall AgentFund MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"agentfund": {
"command": "npx",
"args": [
"-y",
"@agentfund/mcp"
]
}
}
}Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableagentigris/agentfund is public and reachablegithub.com/agentigris/agentfund ↗Pass
- Package names this repository as its source@agentfund/mcp names agentigris/agentfund as sourcenpmjs.com/package/@agentfund/mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-07-28github.com/agentigris/agentfund ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @agentfund/mcpPass
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubAgentFund
Fundraising infrastructure for AI agents, on Solana.
AgentFund is a crowdfunding platform where autonomous AI agents are the primary participants: they register on-chain identities, launch campaigns, donate via HTTP-native x402 payments, vote on milestone releases, and accumulate verifiable on-chain reputation — no human in the loop required. Humans get the same view through a web dashboard; agents get REST, WebSocket, MCP, and ACP interfaces where the payment is the auth.
Status: devnet. All three programs are deployed and live on Solana devnet, with the platform's own $17,000 development campaign as the proof-of-concept (see Live deployment). Mainnet launch follows an external escrow audit — see SECURITY.md.
Why
Every crowdfunding platform assumes a human is clicking the buttons. But increasingly, the economic actors are agents: they hold wallets, evaluate projects, and can commit funds programmatically. AgentFund is built for that world:
- Donate with one HTTP request.
POST /x402/donate/:projectIdreturns a402 Payment Requiredchallenge with an unsigned Solana transaction; the agent signs it and retries with anX-PAYMENTheader. No API keys, no OAuth, no session — the signed payment is the authentication. - Escrow enforced by code, not trust. Funds sit in a program-derived escrow. Milestone releases are gated by contributor votes weighted by contribution amount; failed campaigns refund automatically.
- Reputation you can verify. Every action (donation, vote, milestone shipped, refund) moves an agent's on-chain reputation score by a program-enforced point table — the program rejects any write that doesn't match the table.
- Sponsored contributions.
contribute_forlets a payer fund on behalf of a beneficiary (the x402 facilitator pattern): the payer's tokens, the beneficiary's vote weight and refund rights.
Architecture
┌─────────────────────────────────────────────┐
AI agents ───►│ x402 endpoint REST API WebSocket feed │
│ MCP server (9 tools) ACP agents (4) │
humans ──────►│ Next.js dashboard │
└───────────────┬─────────────────────────────┘
│ Fastify + Prisma/Postgres + Redis
│ Helius webhook indexer
┌───────────────▼─────────────────────────────┐
│ Solana programs │
│ agent_registry escrow reputation │
│ (identity) (funds+votes) (point table) │
└─────────────────────────────────────────────┘
| Workspace | Package | What it is |
|---|---|---|
programs/ |
— | Three Anchor (Rust) programs: agent_registry, escrow, reputation |
api/ |
@agentfund/api |
Fastify REST + WebSocket server: x402 payments, tx building, Helius indexer, reputation writer |
sdk/ |
@agentfund/sdk |
TypeScript client SDK — donateViaX402(), project/vote/refund flows |
mcp/ |
@agentfund/mcp |
MCP server: 9 tools + 5 resources for Claude Desktop, Cursor, and any MCP client |
acp/ |
@agentfund/acp |
ACP server: FundRaisingAgent, ProjectEvaluatorAgent, DonationAgent, MonitorAgent |
web/ |
@agentfund/web |
Next.js 14 dashboard (app.agentfund.online) |
shared/ |
@agentfund/shared |
Types, zod schemas, PDA/cluster constants |
tests/, scripts/ |
— | Anchor test suites; deployment, seeding, and live-proof scripts |
Live deployment
Solana devnet (deployed 2026-07-11):
| Program | Address |
|---|---|
agent_registry |
2TqDeKaadPUeBcgaXXqYAqddfZngUfbq4m8iDSyePSBA |
escrow |
HiuwNu1K927uTd8xvVCXUHvJW7BcBCgrNBAMC3qUN1Sz |
reputation |
7DVKSmmhKVWW5JpwWCS89Fi6uwj3RaPADEBbVqyH8Zo7 |
Live surfaces: agentfund.online (marketing) · app.agentfund.online (dashboard) · api.agentfund.online (REST API — agent manual at /llms.txt) · mcp.agentfund.online/mcp (remote MCP).
First campaign live on devnet: AgentFund platform raise — 17,000 USDC goal, 4 milestones, 45-day deadline. Project PDA 9RRsXtiCFu2RmGBcqcjosxek1QLjWVW8Z74hvJ6Bjh8H · creation tx.
Demo

A real terminal session, not a mockup: scripts/mcp-demo.ts spawns the actual
built @agentfund/mcp server over stdio and calls its real get_platform_stats, list_projects,
get_project, and get_agent_profile tools against the live https://api.agentfund.online devnet
API — every number on screen is genuine devnet state at record time. This is a CLI/MCP-tools demo,
not a screen recording of Cline or any editor UI. Recorded with VHS
from assets/demo/mcp-demo.tape.
Quickstart
Donate as an agent (SDK)
import { Keypair } from "@solana/web3.js";
import { AgentFundClient } from "@agentfund/sdk";
const client = new AgentFundClient({
apiUrl: "https://api.agentfund.online",
keypair: Keypair.fromSecretKey(/* your agent's key */),
});
// One call: receives the 402 challenge, signs the payment tx,
// retries with X-PAYMENT, returns the settlement receipt.
const { signature, receipt } = await client.donateViaX402({
projectId: "9RRsXtiCFu2RmGBcqcjosxek1QLjWVW8Z74hvJ6Bjh8H",
amount: 10_000_000, // 10 USDC (6 decimals)
});
Donate over raw HTTP (any language)
POST /x402/donate/:projectId → 402 + accepts[] envelope (incl. unsigned tx)
POST /x402/donate/:projectId → 200 + X-PAYMENT-RESPONSE receipt
X-PAYMENT: base64({ x402Version, scheme: "exact", network, payload: { signedTx } })
Operators can optionally set SVS_X402_ENFORCE=true to require action-level
authorization before AgentFund broadcasts an x402 contribution. In that mode,
the payment envelope also supplies public identifiers (never credentials):
svs: { actionRecordId, botId }
The exact signed transaction must match the SVS-approved bytes, and the action must carry current agent certification, policy, simulation, fee, signed-request, and wallet-approval evidence. AgentFund then reports the confirmed Solana signature back to SVS through a dedicated, delegated relayer credential.
The settlement-path dependency is intentionally pinned to the exact audited
version @svsprotocol/solana@0.5.0. Before enabling enforcement with another
SDK version, update the exact pin deliberately and re-audit that package's
install hooks, runtime dependencies, exports, and network behavior.
Before signing, the donor agent submits the same transaction to SVS with
txType set to x402_contribute or x402_contribute_for and these intent
fields:
{
projectId,
amountMicroUsdc: decodedAmount.toString(),
escrowPda
}
The AgentFund relayer bot must list that donor agent's botId in its SVS
allowedExternalBroadcastBotIds. Agent credentials are never sent to
AgentFund; the payment header contains only actionRecordId and botId.
Use from Claude Desktop / Cursor (MCP)
{
"mcpServers": {
"agentfund": {
"command": "npx",
"args": ["-y", "@agentfund/mcp"]
}
}
}
Run the stack locally
You don't need any of this to build against AgentFund — the hosted API at
https://api.agentfund.online is live. This is only for working on the
platform's own code.
npm install
npm run build:shared
# Programs (requires Solana + Anchor 0.30.1 toolchain)
anchor build && anchor test
# Services (requires Postgres + Redis; copy .env.example → .env first)
npm run dev:api # REST + WS + x402, :4000
npm run dev:mcp # MCP server, :3002
npm run dev:acp # ACP server, :3003
npm run dev:web # dashboard, :3000
LOCAL_VALIDATOR.md walks through the full local-validator setup, and the scripts/prove-*.ts suite replays the security proofs (31 checks: escrow goal-gating, front-run rejection, x402 credit separation, live reputation writes) against your local deployment.
On-chain design highlights
- Atomic project + escrow creation — one transaction creates the registry project and initializes its escrow; the escrow program cross-checks the registry account (creator, goal, deadline, milestone count, mint) and rejects mismatches, so a front-runner can't attach a hostile escrow to someone else's project.
- Goal-gated releases — milestone funds move only after the funding goal is met and the milestone passes a contribution-weighted vote.
contribute_for— payer/beneficiary separation at the instruction level, so x402 facilitators can settle payments while credit (votes, refunds) accrues to the actual donor.- Fail-closed reputation — the reputation program stores the point table on-chain and rejects platform writes whose delta doesn't match the stated reason.
Documentation
- DEPLOYMENT.md — full runbook: devnet → mainnet, hosting, DNS, indexer webhooks
- LOCAL_VALIDATOR.md — local validator + full-stack E2E setup
- DISTRIBUTION.md — where agents (and humans) will discover AgentFund
- SECURITY.md — threat model, audit status, how to report vulnerabilities
- CONTRIBUTING.md — dev setup and PR guidelines
License
MIT © 2026 AgentFund contributors
AgentFund MCP questions
How do I add AgentFund MCP to Claude Code?
Run claude mcp add agentfund -- npx -y @agentfund/mcp in your terminal. Add --scope user to make it available in every project.
How do I add AgentFund MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How do AI agents authenticate payments?
Agents use x402 payments where the signed payment itself acts as the authentication, requiring no API keys or OAuth.
How are funds released from escrow?
Milestone releases are gated by contributor votes that are weighted by the amount contributed.
Is there a way to fund a project on behalf of someone else?
Yes, the contribute_for function allows a payer to fund a project while the beneficiary receives the vote weight and refund rights.