MCP tools and resources
Tools
| Tool | Description |
|---|---|
list_interfaces | List interfaces, optionally filtered by owner |
get_interface | Get interface by TypeID |
resolve_interface_path | Resolve by canonical owner (@user or org slug) + slug; returns canonicalUrl |
create_interface | Create a new interface |
update_interface | Update name, description, or visibility |
create_revision | Save a draft specification revision |
list_revisions | List revision history |
get_revision | Fetch a revision including spec body |
create_release | Publish a semver release (requires human elicitation) |
list_releases | List published releases |
validate_spec | Validate OpenAPI or JSON Schema without saving |
list_organizations | List orgs the caller belongs to |
list_org_members | List org members for collaboration context |
Resources
| URI template | Content |
|---|---|
ifc://interfaces/{interfaceId} | Interface descriptor (JSON) |
ifc://interfaces/{interfaceId}/latest | Latest revision spec (plain text) |
ifc://interfaces/{interfaceId}/releases/{version} | Release revision spec (plain text) |
Guidance for agents
- Prefer
resolve_interface_pathwhen you know owner + slug. - Validate with
validate_specbeforecreate_revisionwhen the body may be invalid. - Never skip elicitation for
create_release. - Use org-owned interfaces for shared work.