Obelinf

Query and update the documentation of your network.

GitHub
1
Try this MCPSponsored

Documentation

Obelinf MCP Server

Hosted Model Context Protocol server for Obelinf, the network and infrastructure documentation platform. Connect AI agents like Claude, Cursor, or Codex to your infrastructure records and let them query, answer, and update sites, racks, devices, IP address space, and cabling through one endpoint.

This repository does not contain the server's source code. It holds the MCP listing metadata, connection docs, the changelog for the MCP surface, and the public issue tracker.

Quick start

  1. Sign in at obelinf.com and open your organization. MCP is available on all plans, including the free Personal plan.
  2. Create an API key: Dashboard → API Keys → create a key and choose a scope: Read Only or Full Access. Copy it when shown; it is only displayed once.
  3. Add the server to your MCP client. Your endpoint is https://api.obelinf.com/mcp?org=<your-org-slug>, where <your-org-slug> is your organization slug from the dashboard URL.

Cursor (plugin)

Install the Obelinf/mcp repository as a Cursor plugin from the Cursor directory. The plugin declares ORG_SLUG and OBELINF_API_KEY as variables — set them once under Plugins → Configure and the server connects automatically. No manual JSON editing needed.

To add it manually instead, use the config below.

Claude Code

claude mcp add --transport http obelinf "https://api.obelinf.com/mcp?org=<your-org-slug>" \
  --header "Authorization: Bearer YOUR_API_KEY"

Claude Desktop, Cursor, and other JSON-configured clients

{
  "mcpServers": {
    "obelinf": {
      "url": "https://api.obelinf.com/mcp?org=<your-org-slug>",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "obelinf": {
      "type": "http",
      "url": "https://api.obelinf.com/mcp?org=<your-org-slug>",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Other MCP clients: point them at the URL above over Streamable HTTP and send the API key as an Authorization: Bearer header.

Endpoint details

PropertyValue
Endpointhttps://api.obelinf.com/mcp?org={orgSlug}
TransportMCP Streamable HTTP
AuthenticationScoped API keys (Authorization: Bearer)
Rate limit100 requests per minute
AvailabilityAll plans
Tools52

Tools

GroupToolsDescription
SearchsearchCross-resource full-text search across your inventory
Siteslist_sites, get_site, create_site, update_site, delete_sitePhysical locations and data center sites
Rackslist_racks, get_rack, create_rack, update_rack, delete_rackRack inventory, units, and positions
Deviceslist_devices, get_device, create_device, update_device, delete_deviceServers, switches, appliances, and VMs
Subnetslist_subnets, get_subnet, create_subnet, update_subnet, delete_subnetIPAM subnets and prefixes
IP addresseslist_ip_addresses, get_ip_address, create_ip_address, update_ip_address, delete_ip_addressAssigned and free addresses
VLANslist_vlans, get_vlan, create_vlan, update_vlan, delete_vlanVLAN groups and IDs
VRFslist_vrfs, get_vrf, create_vrf, update_vrf, delete_vrfVirtual routing and forwarding instances
Cableslist_cables, get_cable, create_cable, update_cable, delete_cableCabling between ports and endpoints
MAC addresseslist_mac_addresses, get_mac_address, create_mac_address, update_mac_address, delete_mac_addressMAC inventory and assignments
Contactslist_contacts, get_contact, create_contact, update_contact, delete_contactPeople and vendors tied to infrastructure
Changeloglist_changelogAudit trail of every change, with actor and field-level diffs

Permissions

  • Read Only keys can use all read and search tools. Write tools return an error.
  • Full Access keys can read and write. Every write is recorded in the organization changelog with attribution and field-level diffs, so agent edits are as reviewable as manual ones.

Start agents on a Read Only key, review their diffs, then promote to Full Access deliberately.

Support