# FirstKey

> FirstKey is a freemium MCP server for cloud and infrastructure. Agent wallets, a free cycles faucet and one-command site deploys on ICP. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, Web
- **Website:** https://firstkey.io
- **Repository:** https://github.com/firstkeyhq/firstkey-mcp
- **MCP Registry name:** io.github.FirstKeyHQ/firstkey-mcp
- **Categories:** cloud and infrastructure
- **Listing updated:** 2026-11-17

## About

FirstKey helps AI agents get started on the Internet Computer. Its server can generate a fresh Ed25519 wallet, claim a one-time grant of 1 trillion cycles from a faucet, check cycles balance, and deploy a static site to a permanent address. The site says that grant is enough to publish a full website, with one free deploy per agent.

When the free fuel runs out, a human tops up by card through a Stripe checkout and the agent never touches crypto. The server also offers a read-only ICPSwap quote that moves no tokens. It is itself a canister on the Internet Computer, speaks JSON-RPC over Streamable HTTP, is stateless and has CORS enabled.

The README lists seven tools, from wallet creation to fuel links. Wallet keys are returned once and never stored, according to the docs, and sites are served from a canister the agent controls.

## Features

- **Wallet creation:** Generates an Ed25519 wallet and returns the key once.
- **Free faucet grant:** Claims 1T cycles once per wallet.
- **Site deployment:** Creates a site canister and uploads static files.
- **Cycles balance:** Reads a principal's balance on the cycles ledger.
- **Card top-ups:** Returns a link for humans to pay for more fuel.
- **Swap quotes:** Read-only ICPSwap price quotes.

## Good for

- Give a new agent a wallet and starter funds
- Publish a static site from an agent session
- Check how much compute fuel remains
- Generate a payment link for a human to refuel an agent

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http firstkey-mcp https://mcp.firstkey.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.firstkey.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "firstkey-mcp": {
      "url": "https://mcp.firstkey.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "firstkey-mcp": {
      "type": "http",
      "url": "https://mcp.firstkey.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "firstkey-mcp": {
      "serverUrl": "https://mcp.firstkey.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "firstkey-mcp": {
      "type": "http",
      "url": "https://mcp.firstkey.io/mcp"
    }
  }
}
```

## Tools

- `create_wallet`: Generates a fresh Ed25519 wallet; the key is returned once.
- `claim_faucet_grant`: Claims the one-time free 1T cycles grant for an agent principal.
- `deploy_site`: Creates a site canister, installs the static host and uploads files.
- `deploy_upload_chunk`: Chunked upload of large files to a deployed site.
- `check_cycles`: Reads a principal's cycles balance.
- `get_fuel_link`: Returns the card-payment link to refuel an agent.
- `get_swap_quote`: Read-only ICPSwap quote with no tokens moved.

## FAQ

### Do agents need crypto?

The site says the agent never touches crypto; humans pay by card for extra fuel.

### What does the free grant include?

A one-time 1 trillion cycles per wallet.

### Is the private key stored?

The README says the key is returned once and never stored.

### How many free deploys are allowed?

One free deploy per agent.

### Is FirstKey free?

FirstKey has a free plan, with paid plans for more usage or features.

### How do I add FirstKey to Claude Code?

Run this command in your terminal: claude mcp add --transport http firstkey-mcp https://mcp.firstkey.io/mcp

### What are the best alternatives to FirstKey?

The closest alternatives to FirstKey are Agent Yurt, Proofline, filex, MagicWP MCP and Kubana Cloud Domains.

## Alternatives

- [Agent Yurt](https://ai-powered.com/mcp/agent-yurt): Agent Yurt is a free MCP server for knowledge and memory.
- [Proofline](https://ai-powered.com/mcp/proofline): Proofline is a freemium MCP server for developer tools.
- [filex](https://ai-powered.com/mcp/filex): filex is an open-source MCP server for files and documents.
- [MagicWP MCP](https://ai-powered.com/mcp/magicwp-mcp): MagicWP MCP is an MCP server for cloud and infrastructure.
- [Kubana Cloud Domains](https://ai-powered.com/mcp/kubana-cloud-domains): Kubana Cloud Domains is a paid MCP server for cloud and infrastructure.
- [Kubana Cloud DNS Management](https://ai-powered.com/mcp/kubana-cloud-dns-management): Kubana Cloud DNS Management is a free MCP server for cloud and infrastructure.
- [Kubana Cloud VPS](https://ai-powered.com/mcp/kubana-cloud-vps): Kubana Cloud VPS is a paid MCP server for cloud and infrastructure.
- [AgentViva](https://ai-powered.com/mcp/agentviva): AgentViva is a free MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/firstkey
