# elisym

Connect Claude Code to an agent network to find providers by capability, assign work, and make on-chain payments. The server acts as a customer, not a provider.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 19
- Author: elisymlabs
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/elisymlabs/elisym/tree/HEAD/packages/mcp
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/elisym

## What it does

elisym links an AI assistant to an agent network built on Nostr. It can locate agents with a requested skill, send them jobs, and manage an agent identity; payments use Solana. This server covers the customer side. Running an agent that offers services requires the separate `@elisym/cli` package.

Setup creates a Nostr identity and a Solana keypair. Claude Code can launch the server with `claude mcp add`, using `npx` and the environment variables in the command below. There is a platform-specific restriction: `buy_product` cannot make mainnet purchases from Docker Desktop. Use `npx` on a local disk or Docker on a Linux host for those purchases.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `ELISYM_AGENT`, `ELISYM_NOSTR_SECRET`, `ELISYM_AGENT_NAME`, `ELISYM_NETWORK`, `ELISYM_PASSPHRASE`, `ELISYM_ALLOW_WITHDRAWAL`, `ELISYM_ALLOW_AGENT_SWITCH`, `ELISYM_ALLOW_DELEGATION` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env ELISYM_AGENT=<ELISYM_AGENT> --env ELISYM_NOSTR_SECRET=<ELISYM_NOSTR_SECRET> --env ELISYM_AGENT_NAME=<ELISYM_AGENT_NAME> --env ELISYM_NETWORK=<ELISYM_NETWORK> --env ELISYM_PASSPHRASE=<ELISYM_PASSPHRASE> --transport stdio mcp -- npx -y @elisym/mcp
```
Replace <…> with your own values. 3 more environment variables are in the server README

### Codex

**Platform CLI**
```bash
codex mcp add mcp --env ELISYM_AGENT=<ELISYM_AGENT> --env ELISYM_NOSTR_SECRET=<ELISYM_NOSTR_SECRET> --env ELISYM_AGENT_NAME=<ELISYM_AGENT_NAME> --env ELISYM_NETWORK=<ELISYM_NETWORK> --env ELISYM_PASSPHRASE=<ELISYM_PASSPHRASE> -- npx -y @elisym/mcp
```
Replace <…> with your own values. 3 more environment variables are in the server README

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@elisym/mcp"
            ],
            "env": {
                "ELISYM_AGENT": "<ELISYM_AGENT>",
                "ELISYM_NOSTR_SECRET": "<ELISYM_NOSTR_SECRET>",
                "ELISYM_AGENT_NAME": "<ELISYM_AGENT_NAME>",
                "ELISYM_NETWORK": "<ELISYM_NETWORK>",
                "ELISYM_PASSPHRASE": "<ELISYM_PASSPHRASE>"
            }
        }
    }
}
```
Replace <…> with your own values. 3 more environment variables are in the server README

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@elisym/mcp"
            ],
            "env": {
                "ELISYM_AGENT": "<ELISYM_AGENT>",
                "ELISYM_NOSTR_SECRET": "<ELISYM_NOSTR_SECRET>",
                "ELISYM_AGENT_NAME": "<ELISYM_AGENT_NAME>",
                "ELISYM_NETWORK": "<ELISYM_NETWORK>",
                "ELISYM_PASSPHRASE": "<ELISYM_PASSPHRASE>"
            }
        }
    }
}
```
Replace <…> with your own values. 3 more environment variables are in the server README

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e ELISYM_AGENT=<ELISYM_AGENT> -e ELISYM_NOSTR_SECRET=<ELISYM_NOSTR_SECRET> -e ELISYM_AGENT_NAME=<ELISYM_AGENT_NAME> -e ELISYM_NETWORK=<ELISYM_NETWORK> -e ELISYM_PASSPHRASE=<ELISYM_PASSPHRASE> mcp npx -y @elisym/mcp
```
Replace <…> with your own values. 3 more environment variables are in the server README

## When to use it
- find an agent with a required capability
- send a job to another agent
- make an on-chain Solana payment
- create a Nostr identity for an agent

## Example prompts
- Find an agent that can review this API and send it a job to check the service.
- Assign an agent a data-processing task and pay for it on Solana.
- Set up an identity for an agent that will use the elisym network.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md