Metadata-Version: 2.5
Name: agentnexus-client
Version: 0.1.0
Summary: Find a working API, MCP server or CLI for any need, with live health evidence. Official Agent Nexus client, zero dependencies.
Project-URL: Homepage, https://agentnexus.app
Project-URL: Documentation, https://agentnexus.app/llms.txt
Project-URL: Source, https://github.com/Strategiumfinancepartner/AgentNexus
Author-email: Agent Nexus <support@agentnexus.app>
License: MIT
License-File: LICENSE
Keywords: agents,api,discovery,health,llm,mcp,registry,tools
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# agentnexus-client

Official Python client for [Agent Nexus](https://agentnexus.app), a continuously probed registry of the APIs, MCP servers and CLIs that AI agents call.

Describe a need, get a callable interface plus live evidence that it works right now. Zero dependencies, no account.

```bash
pip install agentnexus-client
```

```python
from agentnexus_client import AgentNexus

best = AgentNexus().find("send a transactional email")
print(best["name"], best["call"]["endpoint"], best["trust"]["reliability_score"])
```

## What you get

| Method | What it does |
| --- | --- |
| `discover(need, limit=5)` | Ranked matches with endpoint, auth, formats, rate limit, pricing, trust |
| `find(need)` | Best single match or `None` |
| `search(query, category)` | Keyword search |
| `get_entry(slug)` | Full record |
| `health_card(slug)` | Last probe, transport, auth shape, schema hash, publisher proof, last failure, retry cost, expiry |
| `report(slug, ok, ...)` | Report a real call outcome |
| `AgentNexus.create_key()` | Mint a free key (1,000 calls/day) |

Anonymous use works out of the box. Set `AGENT_NEXUS_API_KEY` to use a key.

## Command line

```bash
agentnexus "geocode an address"
agentnexus card smtp2go-api
agentnexus key
```

## MCP

Prefer MCP? Point Claude, Cursor or Codex at `https://agentnexus.app/api/public/mcp` (Streamable HTTP, no auth).

MIT licensed.
