Search / io.github.FirstKeyHQ/firstkey-mcp
FirstKey
not classifiedFirstKey MCP: agent wallets, free cycles faucet, and one-command site deploys on ICP.
v0.1.0 · active · repository · website · descriptor JSON · versions
Search / io.github.FirstKeyHQ/firstkey-mcp
FirstKey MCP: agent wallets, free cycles faucet, and one-command site deploys on ICP.
v0.1.0 · active · repository · website · descriptor JSON · versions
{
"mcpServers": {
"firstkey-mcp": {
"type": "http",
"url": "https://mcp.firstkey.io/mcp"
}
}
}claude mcp add --transport http firstkey-mcp https://mcp.firstkey.io/mcp[mcp_servers.firstkey-mcp]
url = "https://mcp.firstkey.io/mcp"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"firstkey-mcp": {
"type": "remote",
"url": "https://mcp.firstkey.io/mcp",
"enabled": true
}
}
}{
"mcpServers": {
"firstkey-mcp": {
"type": "http",
"url": "https://mcp.firstkey.io/mcp"
}
},
"deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=firstkey-mcp&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vbWNwLmZpcnN0a2V5LmlvL21jcCJ9"
}{
"servers": {
"firstkey-mcp": {
"type": "http",
"url": "https://mcp.firstkey.io/mcp"
}
}
}{
"mcpServers": {
"firstkey-mcp": {
"httpUrl": "https://mcp.firstkey.io/mcp"
}
}
}extensions:
"firstkey-mcp":
enabled: true
name: "firstkey-mcp"
type: streamable_http
uri: "https://mcp.firstkey.io/mcp"
timeout: 300
protocol.modernnewest supported version is 2025-06-18; 2026-07-28 not supported, older versions are deprecated until 2027-07-28protocol.statelessonly applies to 2026-07-28 serversprotocol.transportstreamable HTTPprotocol.list_ttlonly applies to 2026-07-28 serversauth.prm, auth.as_metadata, auth.cimdno remote uses OAuthauth.secret_in_urlno templated URLtools.descriptionsevery tool has a descriptiontools.description_lengthdescriptions are concisetools.schemasevery tool has an object input schematools.annotationsno tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky onestools.directory_hintsno tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: claim_faucet_grant (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); get_fuel_link (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); create_wallet (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …tools.token_costabout 1,333 tokens to load every tooltools.api_dumptools are not a one-to-one API dumpstability.changes2 tool changes in 30 daysstability.rug_pullno tool changed its meaning under the same namedeps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI packageget_swap_routeaddedRoute a swap intent across ICPSwap: prices the direct pool and every two-hop path through ICP, ckUSDC, ckUSDT, ckBTC, and ckETH live on-chain, chains each leg's quoted output into the next leg's input, and returns the best route leg-by-leg. Read-only — no tokens move. Use this instead of get_swap_quote when a direct pool may be thin or missing.
get_swap_quoteaddedGet a live, read-only swap quote on ICPSwap (the deepest on-chain DEX on ICP): how much receive_token you would get for pay_amount of pay_token. No tokens move — this prices the intent; execution happens in the agent's own wallet/canister. Tokens can be symbols (ICP, ckUSDC, ckUSDT, ckBTC, ckETH) or ledger principals.
Full history: list_changes · trend: quality JSON.
Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.
+repository +namespace-matches-repo +website -unreachable(3 failures) +updated-25d-ago
Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.
| remote | auth | reachable | uptime 30d | p50 | protocol | last ok |
|---|---|---|---|---|---|---|
https://mcp.firstkey.io/mcp streamable-http | none | no (3 failures) | 93% | 1863 ms | 2025-06-18 | 2026-10-17 |
check_cycles | Read an ICP principal's cycles balance on the cycles ledger. |
claim_faucet_grant | Claim the one-time free 1T cycles grant from the FirstKey faucet for an agent principal. One claim per principal, ever. The grant lands on the cycles ledger and funds the agent's first canister deploy. |
create_wallet | Generate a fresh Ed25519 wallet for an AI agent: returns the ICP principal and the PKCS#8 PEM private key. The private key is returned exactly once over this call and is never stored anywhere. No signup, no on-chain registration — the keypair IS the wallet. |
deploy_site | Deploy a static website for an agent: creates a canister on the Internet Computer, installs the FirstKey static host, uploads every file, and returns the live https URL. The agent is added as a controller of its site canister. One free deploy per agent principal, funded from the FirstKey deploy pool; files must fit in one call (total under ~1.4 MB decoded) — use deploy_upload_chunk for larger files. |
deploy_upload_chunk | Upload one chunk of a large file to an already-deployed agent site (for files that don't fit in a single deploy_site call). Chunks are appended in order; set is_last on the final chunk to publish the file. |
get_fuel_link | Get the FirstKey Fuel payment link for a principal: a human pays by card (Stripe) and cycles land in the agent's wallet — the sovereign refuel path when the free faucet grant or deploy pool is exhausted. |
get_swap_quote | Get a live, read-only swap quote on ICPSwap (the deepest on-chain DEX on ICP): how much receive_token you would get for pay_amount of pay_token. No tokens move — this prices the intent; execution happens in the agent's own wallet/canister. Tokens can be symbols (ICP, ckUSDC, ckUSDT, ckBTC, ckETH) or ledger principals. |
get_swap_route | Route a swap intent across ICPSwap: prices the direct pool and every two-hop path through ICP, ckUSDC, ckUSDT, ckBTC, and ckETH live on-chain, chains each leg's quoted output into the next leg's input, and returns the best route leg-by-leg. Read-only — no tokens move. Use this instead of get_swap_quote when a direct pool may be thin or missing. |
Schemas: list_tools.
{
"name": "io.github.FirstKeyHQ/firstkey-mcp",
"title": "FirstKey",
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"remotes": [
{
"url": "https://mcp.firstkey.io/mcp",
"type": "streamable-http"
}
],
"version": "0.1.0",
"repository": {
"url": "https://github.com/FirstKeyHQ/firstkey-mcp",
"source": "github"
},
"websiteUrl": "https://firstkey.io",
"description": "FirstKey MCP: agent wallets, free cycles faucet, and one-command site deploys on ICP."
}