🤖 MCP

The Lighthouse MCP server lets an AI client call the Lighthouse API as tools. It is deployed at https://mcp.lighthouse.storage/mcp.

After you connect a client and sign in, you can ask in plain language for uploads, storage usage, IPNS records, deals, bandwidth, and gateway details. The client calls the matching tool.

1. Connect a client

In Cursor, add the server under MCP settings:

{
  "mcpServers": {
    "lighthouse": {
      "url": "https://mcp.lighthouse.storage/mcp"
    }
  }
}

Reload MCP servers. The Lighthouse server should show as connected.

Any other MCP client that supports Streamable HTTP can use the same URL.

2. Sign in

The server does not read a wallet from the chat by itself. Sign in once in the conversation, then later prompts can omit the public key.

1. Ask the client to call get_auth_message with your wallet public key.
2. Sign the returned message in your wallet.
3. Paste the signature and ask the client to call verify_signer with your public key and signedMessage.

If you already have an API key or access token, skip the signature and ask the client to call verify_api_key or verify_access_token.

auth_status shows the wallet signed in for this connection. sign_out clears it.

3. Ask for something

With a signed-in session, prompts like these are enough:

• "Show my storage usage."
• "List my uploads."
• "What is the deal status for this CID?"
• "List my IPNS records."
• "Show my gateway subdomain."

The client fills in the tool arguments from the session. You can still pass a publicKey when you want to look up a different wallet.

Tools

Tool	What it does
get_auth_message, verify_signer, verify_api_key, verify_access_token, get_profile	Sign in and read the account
create_api_key, get_user_keys, remove_api_key	Manage API keys
get_uploads, files_uploaded, user_data_usage, delete_file	Files and storage usage
generate_ipns_key, get_ipns_records, publish_ipns_record, remove_ipns_key	IPNS
file_info, deal_status, pin_cid, cid_pin_status	File info, deals, and pinning
get_active_plan_list, user_transactions, purchase_plan_via_stripe	Plans and payments
get_bandwidth_records	Bandwidth
get_gateway_subdomain, gateway_subdomain_info	Gateway subdomain

These tools call the same backend as the HTTP API. A signed-in session can change data, including deleting a file or starting a purchase, so only connect clients you trust.