peering-mcp
An MCP server that lets an AI agent look up how the internet is actually wired together — which networks connect to each other, at which internet exchanges and facilities, under what peering policy, and who a given address range is registered to. It provides five read-only tools over two public sources: PeeringDB for interconnection, and the regional internet registries over RDAP for registration.
Package and access
Local package with source-attributed installation metadata. Koskamo does not execute packages during review.
What you can do with it
- Look up who a network is and their peering policy
- List which internet exchanges and facilities a network is present at
- Find who else is at a specific exchange and if they peer
- Look up who an IP range or AS number is registered to
Source and maintenance
- Maintenance checked
Packages and installation
Source-provided package data. Koskamo has not executed or live-probed this package.
peering-mcp 0.1.1
{
"version": "0.1.1",
"transport": "stdio",
"identifier": "peering-mcp",
"runtimeHint": "uvx",
"registryType": "pypi",
"registryBaseUrl": "https://pypi.org",
"environmentVariables": [
{
"name": "PEERINGDB_API_KEY",
"description": "A free PeeringDB API key. Recommended, not required: it raises the rate limit, and every tool works without one."
},
{
"name": "PEERING_MCP_CACHE_TTL",
"default": "86400",
"description": "How long a cached upstream response stays usable, in seconds."
},
{
"name": "PEERING_MCP_CACHE_DIR",
"description": "Where the on-disk cache lives. Defaults to $XDG_CACHE_HOME/peering-mcp."
},
{
"name": "PEERING_MCP_NO_CACHE",
"description": "Set to 1 to disable caching. Slower, and harder on the upstream APIs."
},
{
"name": "PEERING_MCP_TIMEOUT",
"default": "10",
"description": "Per-request timeout in seconds."
},
{
"name": "PEERING_MCP_MAX_RETRIES",
"default": "3",
"description": "Attempts before an upstream failure is reported."
}
]
}Tools
Reported by the attributed source; not independently observed by Koskamo.
Connect from your client
Each snippet configures the same source-provided package; replace placeholders before use.
Cursor
{
"mcpServers": {
"peering-mcp": {
"command": "uvx",
"args": [
"peering-mcp==0.1.1"
],
"env": {
"PEERINGDB_API_KEY": "<YOUR_PEERINGDB_API_KEY>",
"PEERING_MCP_CACHE_TTL": "<YOUR_PEERING_MCP_CACHE_TTL>",
"PEERING_MCP_CACHE_DIR": "<YOUR_PEERING_MCP_CACHE_DIR>",
"PEERING_MCP_NO_CACHE": "<YOUR_PEERING_MCP_NO_CACHE>",
"PEERING_MCP_TIMEOUT": "<YOUR_PEERING_MCP_TIMEOUT>",
"PEERING_MCP_MAX_RETRIES": "<YOUR_PEERING_MCP_MAX_RETRIES>"
}
}
}
}Cline
{
"mcpServers": {
"peering-mcp": {
"command": "uvx",
"args": [
"peering-mcp==0.1.1"
],
"env": {
"PEERINGDB_API_KEY": "<YOUR_PEERINGDB_API_KEY>",
"PEERING_MCP_CACHE_TTL": "<YOUR_PEERING_MCP_CACHE_TTL>",
"PEERING_MCP_CACHE_DIR": "<YOUR_PEERING_MCP_CACHE_DIR>",
"PEERING_MCP_NO_CACHE": "<YOUR_PEERING_MCP_NO_CACHE>",
"PEERING_MCP_TIMEOUT": "<YOUR_PEERING_MCP_TIMEOUT>",
"PEERING_MCP_MAX_RETRIES": "<YOUR_PEERING_MCP_MAX_RETRIES>"
}
}
}
}VS Code
{
"servers": {
"peering-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"peering-mcp==0.1.1"
],
"env": {
"PEERINGDB_API_KEY": "<YOUR_PEERINGDB_API_KEY>",
"PEERING_MCP_CACHE_TTL": "<YOUR_PEERING_MCP_CACHE_TTL>",
"PEERING_MCP_CACHE_DIR": "<YOUR_PEERING_MCP_CACHE_DIR>",
"PEERING_MCP_NO_CACHE": "<YOUR_PEERING_MCP_NO_CACHE>",
"PEERING_MCP_TIMEOUT": "<YOUR_PEERING_MCP_TIMEOUT>",
"PEERING_MCP_MAX_RETRIES": "<YOUR_PEERING_MCP_MAX_RETRIES>"
}
}
}
}Claude Desktop
{
"mcpServers": {
"peering-mcp": {
"command": "uvx",
"args": [
"peering-mcp==0.1.1"
],
"env": {
"PEERINGDB_API_KEY": "<YOUR_PEERINGDB_API_KEY>",
"PEERING_MCP_CACHE_TTL": "<YOUR_PEERING_MCP_CACHE_TTL>",
"PEERING_MCP_CACHE_DIR": "<YOUR_PEERING_MCP_CACHE_DIR>",
"PEERING_MCP_NO_CACHE": "<YOUR_PEERING_MCP_NO_CACHE>",
"PEERING_MCP_TIMEOUT": "<YOUR_PEERING_MCP_TIMEOUT>",
"PEERING_MCP_MAX_RETRIES": "<YOUR_PEERING_MCP_MAX_RETRIES>"
}
}
}
}Let your agent find its tools
Find servers like peering-mcp from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.