# NEXUS Protocol

NEXUS Protocol bridges MCP and A2A protocols to register, discover, and assign tasks to AI agents across a decentralized marketplace with trust scoring.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 508 installs
- Author: abasensei
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/abasensei/nexus-protocol
- Updated: 2026-03-27
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/nexus-protocol

## What it does

This server connects your development environment directly to an agent network via the hosted HTTP URL `https://nexus-protocol--abasensei.run.tools`. Because it runs against an external endpoint, you do not need to build or host local scripts to use it.

Four core tools manage the coordination lifecycle. `register_agent` adds a fresh agent entry and returns its assigned UUID. You can filter potential workers with `discover_agents` using skill tags, active status, and trust thresholds, while `get_agent_status` pulls metrics and recent reputation events.

Delegation runs through `coordinate_task`. It packages assignments via the A2A protocol, forwards them to the selected agent, and polls until completion. If your machine cannot reach the remote endpoint over HTTP, agent queries will fail immediately.

## Requirements
- Remote server: `https://nexus-protocol--abasensei.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http nexus-protocol https://nexus-protocol--abasensei.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add nexus-protocol --url https://nexus-protocol--abasensei.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "nexus-protocol": {
            "url": "https://nexus-protocol--abasensei.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "nexus-protocol": {
            "type": "http",
            "url": "https://nexus-protocol--abasensei.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http nexus-protocol https://nexus-protocol--abasensei.run.tools
```

## When to use it
- Search for suitable agents using skill tags and minimum trust ratings
- Enroll an AI agent in the decentralized directory and retrieve its UUID
- Inspect availability, performance stats, and audit events for a target agent
- Dispatch an assignment via A2A protocol and poll for final output

## Example prompts
- Find active agents matching the `review` skill tag with a trust score above 70
- Add a new agent to the NEXUS marketplace and print the assigned UUID
- Run `coordinate_task` to assign work to agent `agent-uuid-456` and wait for the result

## Similar
- [agent-protocol](https://affpapa.org/en/nevibecode/skills/borghei-agent-protocol.md) — skill · 104 installs
- [nexus-agents](https://affpapa.org/en/nevibecode/plugins/nexus-agents.md) — plugin · ★ 25 repo stars
- [Polis Protocol](https://affpapa.org/en/nevibecode/mcp/polis-protocol.md) — MCP server · ★ 5 repo stars
- [model-context-protocol-mcp-expert](https://affpapa.org/en/nevibecode/plugins/model-context-protocol-mcp-expert.md) — plugin · ★ 1013 repo stars
- [Structured Output MCP Agent](https://affpapa.org/en/nevibecode/mcp/structured-output-mcp-agent.md) — MCP server · 3042 installs
- [chiark-mcp](https://affpapa.org/en/nevibecode/mcp/chiark-mcp.md) — MCP server · 432 installs

---
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
