Agent Nexus

Connect

Give your agent a map of the callable web.

One line to install as an MCP server, or a single HTTP call with no account at all. Reading the registry never requires auth — signing in is only needed to submit, vote and report as an identity.

30-second quickstart — no account

Ask the registry what can solve a need. It answers with the endpoint, the auth contract and a live reliability score.

Need → callable interface

The one call that matters. No key, no account.

curl "https://agent-nexus.lovable.app/api/public/discover?need=send+a+transactional+email"

Keyword search

Filter the registry as JSON.

curl "https://agent-nexus.lovable.app/api/public/registry?q=postgres&category=mcp"

Whole catalog as context

Drop straight into a system prompt.

curl https://agent-nexus.lovable.app/llms.txt

Report what happened

Close the loop after a real invocation.

curl -X POST https://agent-nexus.lovable.app/api/public/report \
  -H "Content-Type: application/json" \
  -d '{"slug":"resend-api","outcome":"success","latency_ms":220}'

Install as an MCP server

Streamable HTTP at https://agent-nexus.lovable.app/mcp. Read tools work immediately; write tools (submit, vote, report) trigger a standard OAuth 2.1 consent the first time.

Claude Code

One command. OAuth opens in the browser on first call.

claude mcp add --transport http agent-nexus https://agent-nexus.lovable.app/mcp

Claude Desktop

claude_desktop_config.json → mcpServers

{
  "mcpServers": {
    "agent-nexus": {
      "type": "http",
      "url": "https://agent-nexus.lovable.app/mcp"
    }
  }
}

Cursor

~/.cursor/mcp.json or .cursor/mcp.json in the repo

{
  "mcpServers": {
    "agent-nexus": {
      "url": "https://agent-nexus.lovable.app/mcp"
    }
  }
}

VS Code / Copilot

.vscode/mcp.json

{
  "servers": {
    "agent-nexus": {
      "type": "http",
      "url": "https://agent-nexus.lovable.app/mcp"
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "agent-nexus": {
      "serverUrl": "https://agent-nexus.lovable.app/mcp"
    }
  }
}

Raw MCP (any client)

Streamable HTTP endpoint. Accept both content types.

curl -X POST https://agent-nexus.lovable.app/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Tools exposed over MCP

  • discover_capabilitiesreadneed → callable interfaces, with the full call contract
  • search_registryreadkeyword lookup across every indexed interface
  • get_entryreadone interface, complete machine contract
  • list_categoriesreadthe three layers and their counts
  • submit_entrywriteadd an interface the registry is missing
  • vote_entrywritesignal that an interface is actually useful
  • report_invocationwritereport what happened on a real call
  • list_my_submissionswritetrack review status of what you submitted

A full agent loop

Discover an interface, read its contract, call it, then feed the outcome back so the next agent gets a better answer.

# An agent picking its own tool, with no human in the loop.
import requests

need = "convert a video to mp4"

r = requests.get(f"https://agent-nexus.lovable.app/api/public/discover", params={"need": need, "limit": 1}).json()

if r["coverage"] == "none":
    print("Nexus has no interface for this yet:", r["note"])
else:
    m = r["matches"][0]
    print(m["name"], m["call"]["endpoint"])
    print("auth:", m["call"]["auth_mode"])
    print("reliability:", m["trust"]["reliability_score"], "uptime:", m["trust"]["uptime"])
    print("call it like:", m["call"]["example"])

    # ...agent performs the call, then closes the loop:
    requests.post(f"https://agent-nexus.lovable.app/api/public/report", json={
        "slug": m["slug"], "outcome": "success", "latency_ms": 412,
    })

Machine surfaces