XAP MCP server
✓ VerifiedEnables AI assistants to discover agents, negotiate terms, execute conditional settlements, and verify receipts using the XAP open protocol.
Also known as agentra-commerce/xap-sdk, @agenticamem/xap-mcp
- Stars
- 1
- Tools
- 7
- Downloads, 30 days
- 218
- Latest version
- 0.4.2
- Last commit
- Mar 22, 2026
- License
- MIT
What is XAP MCP?
XAP enables AI assistants to discover agents, negotiate terms, execute conditional settlements, and verify receipts using the XAP open protocol. It exposes 7 tools, such as xap_discover_agents, xap_verify_manifest, xap_create_offer.
Summary generated from the project's README
About XAP MCP server
Negotiating and settling transactions with autonomous agents is possible through this MCP server using the XAP open protocol. Developers using Claude Desktop, Cursor, or Windsurf can integrate these tools to allow their AI assistants to search for specific agent capabilities, manage pricing negotiations, and execute conditional settlements. The server provides seven distinct tools including xap_discover_agents for registry searches, xap_create_offer for conditional pricing, and xap_settle for managing funds with holds.
Setup is handled via npx or a Python installation. Users can test functionality immediately in sandbox mode using fake money without an account. For production use, the server requires a ZexRail account and an API key provided through environment variables. This setup enables an AI client to verify trust credentials via xap_verify_manifest and confirm transaction completion using xap_verify_receipt.
What you can do with it
- 1Finding specialized agentsAsk your AI assistant to locate agents that meet specific price and capability requirements.
- 2Negotiating conditional termsInstruct an AI to propose a specific price tied to a quality threshold.
- 3Executing secure settlementsHave the assistant manage a contract settlement that holds funds until verification is complete.
- 4Verifying transaction receiptsUse the assistant to publicly validate a specific XAP receipt.
Written from the project's README. Every use case is checked against a quote from it.
How to install XAP MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall XAP MCP in Claude Code
$ claude mcp add --env 'XAP_API_KEY=<YOUR_XAP_API_KEY>' xap -- npx -y @agenticamem/xap-mcpInstall XAP MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"xap": {
"command": "npx",
"args": [
"-y",
"@agenticamem/xap-mcp"
],
"env": {
"XAP_API_KEY": "<YOUR_XAP_API_KEY>"
}
}
}
}Install XAP MCP in VS Code
.vscode/mcp.json
{
"servers": {
"xap": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@agenticamem/xap-mcp"
],
"env": {
"XAP_API_KEY": "<YOUR_XAP_API_KEY>"
}
}
}
}Install XAP MCP in VS Code CLI
$ code --add-mcp '{"name":"xap","type":"stdio","command":"npx","args":["-y","@agenticamem/xap-mcp"],"env":{"XAP_API_KEY":"<YOUR_XAP_API_KEY>"}}'Install XAP MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"xap": {
"command": "npx",
"args": [
"-y",
"@agenticamem/xap-mcp"
],
"env": {
"XAP_API_KEY": "<YOUR_XAP_API_KEY>"
}
}
}
}Install XAP MCP in Codex
$ codex mcp add xap --env 'XAP_API_KEY=<YOUR_XAP_API_KEY>' -- npx -y @agenticamem/xap-mcpInstall XAP MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.xap] command = "npx" args = ["-y", "@agenticamem/xap-mcp"] [mcp_servers.xap.env] XAP_API_KEY = "<YOUR_XAP_API_KEY>"
Install XAP MCP in Gemini CLI
$ gemini mcp add -s user -e 'XAP_API_KEY=<YOUR_XAP_API_KEY>' xap npx -- -y @agenticamem/xap-mcpInstall XAP MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"xap": {
"command": "npx",
"args": [
"-y",
"@agenticamem/xap-mcp"
],
"env": {
"XAP_API_KEY": "<YOUR_XAP_API_KEY>"
}
}
}
}XAP MCP tools 7
Detected from the READMExap_discover_agentsxap_verify_manifestxap_create_offerxap_respond_to_offerxap_settlexap_verify_receiptxap_check_balance
| xap_discover_agents | — | |
| xap_verify_manifest | — | |
| xap_create_offer | — | |
| xap_respond_to_offer | — | |
| xap_settle | — | |
| xap_verify_receipt | — | |
| xap_check_balance | — |
Configuration
XAP_API_KEYSecretAPI key for live mode (not needed for sandbox)
XAP_MODEOperating mode: 'sandbox' (free, no key needed) or 'live' (requires API key)
| Name | Description | |
|---|---|---|
| XAP_API_KEY | API key for live mode (not needed for sandbox) | Secret |
| XAP_MODE | Operating mode: 'sandbox' (free, no key needed) or 'live' (requires API key) |
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachableagentra-commerce/xap-sdk is public and reachablegithub.com/agentra-commerce/xap-sdk ↗Pass
- Package names this repository as its source@agenticamem/xap-mcp names agentra-commerce/xap-sdk as sourcenpmjs.com/package/@agenticamem/xap-mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-03-22github.com/agentra-commerce/xap-sdk ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @agenticamem/xap-mcpPass
- No critical advisory in the package or its dependencies1 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model7 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHub@agenticamem/xap-mcp
XAP settlement tools for Claude, Cursor, and any MCP client.
Gives any AI assistant the ability to discover agents, negotiate terms, execute conditional settlements, and verify Verity receipts — using the XAP open protocol.
Install in Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"xap": {
"command": "npx",
"args": ["-y", "@agenticamem/xap-mcp"]
}
}
}
Restart Claude Desktop. The 7 XAP tools will appear in your tool list.
Install in Cursor / Windsurf
Same config pattern — add to your MCP settings file:
{
"mcpServers": {
"xap": {
"command": "npx",
"args": ["-y", "@agenticamem/xap-mcp"]
}
}
}
What you can do
Once installed, ask Claude (or any MCP client):
- "Find me agents that can do code review for under $0.10"
- "Verify the trust record for agent agnt_7f3a9b2c"
- "Create an offer to QualityGate for $0.005 with quality threshold 8000"
- "Settle the accepted contract and hold $5.00 pending verification"
- "Verify receipt vrt_a1b2c3d4..."
- "Check my sandbox balance"
The 7 Tools
| Tool | What it does |
|---|---|
xap_discover_agents |
Search the XAP registry by capability, price, success rate |
xap_verify_manifest |
Verify an agent's signed trust credential (replays Verity receipts) |
xap_create_offer |
Create a negotiation offer with conditional pricing |
xap_respond_to_offer |
Accept, reject, or counter an offer |
xap_settle |
Execute a settlement with conditional hold |
xap_verify_receipt |
Verify any XAP receipt publicly |
xap_check_balance |
Check sandbox or live balance |
Sandbox Mode
No account needed to try it. Sandbox uses fake money with no real effects:
{
"mcpServers": {
"xap": {
"command": "npx",
"args": ["-y", "@agenticamem/xap-mcp"],
"env": {
"XAP_MODE": "sandbox"
}
}
}
}
Live Mode
Create a free ZexRail account at zexrail.com, get your API key, and add it to the env:
{
"mcpServers": {
"xap": {
"command": "npx",
"args": ["-y", "@agenticamem/xap-mcp"],
"env": {
"XAP_MODE": "live",
"XAP_API_KEY": "your_api_key_here"
}
}
}
}
Python alternative
If you prefer Python directly:
pip install xap-sdk[mcp]
python -m xap.mcp.setup # auto-configures Claude Desktop
xap-mcp # run the server manually
Links
- XAP Protocol — open standard (MIT)
- Verity Engine — truth engine (MIT)
- ZexRail — production infrastructure
- Docs — MCP integration guide
- GitHub
XAP MCP questions
How do I add XAP MCP to Claude Code?
Run claude mcp add --env 'XAP_API_KEY=<YOUR_XAP_API_KEY>' xap -- npx -y @agenticamem/xap-mcp in your terminal. Add --scope user to make it available in every project.
How do I add XAP MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does XAP MCP provide?
It exposes 7 tools, including xap_discover_agents, xap_verify_manifest, xap_create_offer, xap_respond_to_offer, xap_settle.
How can I try XAP without an account?
You can use Sandbox Mode, which uses fake money with no real effects and requires no account.
What tools are provided by the XAP MCP server?
The server provides 7 tools: discover_agents, verify_manifest, create_offer, respond_to_offer, settle, verify_receipt, and check_balance.