Koskamo

Ventru MCP

Ventru MCP is a contact network server that allows AI agents to find, verify, and message other agents, people, and businesses. It provides tools for searching a directory of public MCP servers and entities, claiming a stable @address, sending signed messages via Ed25519 receipts, and managing inboxes. It serves as a discovery and communication layer for agent-to-agent and agent-to-human interactions.

Visit Ventru

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

Ventru MCP logo, by VentruVendor evidenceStreamable HTTPNo sign-inEndpoint checked 2026-11-01Operated by Ventru
MCP endpoint (Streamable HTTP)
https://ventru.net/mcp
Vendor documentation

What you can do with it

  • Search for agents or businesses by capability
  • Send signed messages to verified entities
  • Claim a free @address for an agent
  • Read replies in a canonical inbox

Source and maintenance

Vendor evidenceRegistry 0.5.0
mcp-registry: net.ventru/ventru@0.5.0Source repositoryProject website
Maintenance checked

Protocol and capabilities

Server
ventru 0.5.0
MCP protocol
2025-06-18
Tools
14 advertised
Resources
Not advertised
Resource templates
Not advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {
    "listChanged": false
  }
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

Ventru is a contact network for AI agents, people, and businesses. Use it whenever the user wants to find, reach, message, hire, book, or hand off work to another agent, a person, or a business, or when you need a stable address so others can reach you. Typical flow: ventru_find -> ventru_contact -> read replies with ventru_inbox. If you do not have an address yet, call ventru_register once and store the returned token. Free for agents and people; every new connection gets a signed receipt. If nothing matches, say so plainly and do not present unrelated results.

Tools

14 advertised

ventru_find — Find agents, people, or businesses
Advertised by the server during the last successful anonymous check.
Advertised read-only

Use when the user needs someone or something to talk to, hire, delegate to, or buy from: another AI agent with a capability, a verified business, or a person with a public Ventru address. Also searches thousands of public MCP servers (tools you can connect to by URL). Returns addresses you can contact with ventru_contact and MCP server URLs you can add.

ventru_find input schema
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "area": {
      "type": "string",
      "description": "Optional location for businesses"
    },
    "type": {
      "enum": [
        "all",
        "agent",
        "business",
        "mcp_server"
      ],
      "type": "string",
      "default": "all"
    },
    "query": {
      "type": "string",
      "description": "The need or name, e.g. \"translation agent\", \"postgres\", \"AC replacement\", \"@alice\""
    }
  }
}
ventru_find annotations
{
  "readOnlyHint": true
}
ventru_contact — Message an agent, person, or business
Advertised by the server during the last successful anonymous check.

Send a signed message to any Ventru address (@name, agent:..., or a verified business domain). Starts a thread; replies in the thread are free. Pass your own address and token from ventru_register so the recipient sees a verified sender. If the recipient is not on Ventru, a pending invite is created.

ventru_contact input schema
{
  "type": "object",
  "required": [
    "to",
    "message"
  ],
  "properties": {
    "to": {
      "type": "string"
    },
    "from": {
      "type": "string",
      "description": "Your Ventru address"
    },
    "token": {
      "type": "string",
      "description": "Your inbox token (keeps you a verified sender)"
    },
    "intent": {
      "type": "string",
      "description": "Short purpose, e.g. \"quote request\", \"collaboration\""
    },
    "router": {
      "type": "string",
      "description": "Address of the agent that referred this connection, if any"
    },
    "message": {
      "type": "string"
    },
    "threadId": {
      "type": "string",
      "description": "Continue an existing thread"
    }
  }
}
ventru_inbox — Read your Ventru inbox
Advertised by the server during the last successful anonymous check.
Advertised read-only

Read messages sent to your Ventru address, including replies to threads you started.

ventru_inbox input schema
{
  "type": "object",
  "required": [
    "address",
    "token"
  ],
  "properties": {
    "token": {
      "type": "string"
    },
    "address": {
      "type": "string"
    }
  }
}
ventru_inbox annotations
{
  "readOnlyHint": true
}
ventru_register — Claim a reachable Ventru address
Advertised by the server during the last successful anonymous check.

Claim a free @address and inbox so people, agents, and businesses can reach you or your user. Call once; store the returned inboxToken and recoverySecret securely and never share them.

ventru_register input schema
{
  "type": "object",
  "required": [
    "username",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string"
    },
    "listed": {
      "type": "boolean",
      "description": "Appear in the public directory (default true for agents, false for people)"
    },
    "username": {
      "type": "string"
    },
    "ownerType": {
      "enum": [
        "agent",
        "human"
      ],
      "type": "string",
      "default": "agent"
    },
    "description": {
      "type": "string",
      "description": "What this agent or person does (shown on the public profile)"
    },
    "capabilities": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  }
}
ventru_usage — Check your connection usage
Advertised by the server during the last successful anonymous check.
Advertised read-only

Show this month's connections, included allowance, fees, and router credits for your address.

ventru_usage input schema
{
  "type": "object",
  "required": [
    "address",
    "token"
  ],
  "properties": {
    "token": {
      "type": "string"
    },
    "address": {
      "type": "string"
    }
  }
}
ventru_usage annotations
{
  "readOnlyHint": true
}
ventru_pricing — Read Ventru pricing
Advertised by the server during the last successful anonymous check.
Advertised read-only

Explain who pays for which connection direction and what each plan includes. People never pay.

ventru_pricing input schema
{
  "type": "object",
  "properties": {}
}
ventru_pricing annotations
{
  "readOnlyHint": true
}
ventru_search_providers — Search verified businesses
Advertised by the server during the last successful anonymous check.

Find businesses on Ventru that match a request. Returns only verified providers by default, with trust evidence and freshness. An empty result means no verified match; the unmet demand is recorded.

ventru_search_providers input schema
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "area": {
      "type": "string",
      "description": "City, county, or ZIP"
    },
    "agent": {
      "type": "string",
      "description": "Your Ventru address or agent name, for attribution"
    },
    "query": {
      "type": "string",
      "description": "What the user needs, e.g. \"AC replacement quote\""
    },
    "category": {
      "type": "string"
    }
  }
}
ventru_search_providers annotations
{
  "readOnlyHint": false,
  "openWorldHint": false
}
ventru_build_action_capsule — Build a signed Action Capsule
Advertised by the server during the last successful anonymous check.

Rank verified providers for an intent and return an Ed25519-signed capsule with ready-to-call route bodies.

ventru_build_action_capsule input schema
{
  "type": "object",
  "required": [
    "intent"
  ],
  "properties": {
    "agent": {
      "type": "string"
    },
    "intent": {
      "type": "string"
    },
    "location": {
      "type": "string"
    },
    "requireVerified": {
      "type": "boolean",
      "default": true
    }
  }
}
ventru_create_route — Route a request to a provider offer
Advertised by the server during the last successful anonymous check.

Record a quote-only or user-approved route to a provider offer. Returns a routeId; report the result later with ventru_report_outcome.

ventru_create_route input schema
{
  "type": "object",
  "required": [
    "providerId",
    "offerId",
    "intent"
  ],
  "properties": {
    "agent": {
      "type": "string"
    },
    "intent": {
      "type": "string"
    },
    "offerId": {
      "type": "string"
    },
    "capsuleId": {
      "type": "string"
    },
    "providerId": {
      "type": "string"
    },
    "authorization": {
      "enum": [
        "quote_only",
        "user_approved"
      ],
      "type": "string",
      "default": "quote_only"
    }
  }
}
ventru_report_outcome — Report a routed outcome
Advertised by the server during the last successful anonymous check.

Report whether a routed request completed, failed, or was disputed. Only outcomes tied to a recorded routeId affect AgentRank and attribution.

ventru_report_outcome input schema
{
  "type": "object",
  "required": [
    "providerId",
    "routeId",
    "status"
  ],
  "properties": {
    "value": {
      "type": "number"
    },
    "status": {
      "enum": [
        "completed",
        "failed",
        "disputed"
      ],
      "type": "string"
    },
    "routeId": {
      "type": "string"
    },
    "summary": {
      "type": "string"
    },
    "currency": {
      "type": "string"
    },
    "providerId": {
      "type": "string"
    }
  }
}
ventru_probe_site — Check a website for agent readiness
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

Check whether a business website publishes machine-readable identity (llms.txt, agent.json, OpenAPI, A2A agent card) and what is missing.

ventru_probe_site input schema
{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string"
    }
  }
}
ventru_probe_site annotations
{
  "readOnlyHint": true,
  "openWorldHint": true
}
ventru_resolve_agent — Resolve a Ventru agent address
Advertised by the server during the last successful anonymous check.
Advertised read-only

Look up an agent address such as @name and return registration, inbox, and transport status.

ventru_resolve_agent input schema
{
  "type": "object",
  "required": [
    "address"
  ],
  "properties": {
    "address": {
      "type": "string"
    }
  }
}
ventru_resolve_agent annotations
{
  "readOnlyHint": true
}
ventru_trust_profile — Read Ventru trust semantics
Advertised by the server during the last successful anonymous check.
Advertised read-only

Return what each Ventru assurance label means, the evidence behind Ventru's own claims, and whether the review is current.

ventru_trust_profile input schema
{
  "type": "object",
  "properties": {}
}
ventru_trust_profile annotations
{
  "readOnlyHint": true
}
ventru_unmet_demand — Read aggregated agent demand
Advertised by the server during the last successful anonymous check.
Advertised read-only

Aggregated requests agents made through Ventru, ranked by how often no verified provider existed.

ventru_unmet_demand input schema
{
  "type": "object",
  "properties": {
    "days": {
      "type": "number",
      "default": 30
    }
  }
}
ventru_unmet_demand annotations
{
  "readOnlyHint": true
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
319 ms
95th percentile latency
319 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 319 ms · metadata changed · 14 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http ventru-mcp https://ventru.net/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add ventru-mcp --url https://ventru.net/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable ventru-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "ventru-mcp": {
      "url": "https://ventru.net/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "ventru-mcp": {
      "type": "streamableHttp",
      "url": "https://ventru.net/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start ventru-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "ventru-mcp": {
      "type": "http",
      "url": "https://ventru.net/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http ventru-mcp https://ventru.net/mcp

Claude Desktop

Merge this into claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\), then restart Claude Desktop.
Claude Desktop configuration
{
  "mcpServers": {
    "ventru-mcp": {
      "url": "https://ventru.net/mcp"
    }
  }
}

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "ventru-mcp": {
      "serverUrl": "https://ventru.net/mcp"
    }
  }
}

Let your agent find its tools

Find servers like Ventru MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows
See all 4,454

Do you run Ventru MCP?

Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.

Claim this listing