Skip to content

MCP tools and resources ​

Tools ​

ToolDescription
list_interfacesList interfaces, optionally filtered by owner
get_interfaceGet interface by TypeID
resolve_interface_pathResolve by canonical owner (@user or org slug) + slug; returns canonicalUrl
create_interfaceCreate a new interface
update_interfaceUpdate name, description, or visibility
create_revisionSave a draft specification revision
list_revisionsList revision history
get_revisionFetch a revision including spec body
create_releasePublish a semver release (requires human elicitation)
list_releasesList published releases
validate_specValidate OpenAPI or JSON Schema without saving
list_organizationsList orgs the caller belongs to
list_org_membersList org members for collaboration context

Resources ​

URI templateContent
ifc://interfaces/{interfaceId}Interface descriptor (JSON)
ifc://interfaces/{interfaceId}/latestLatest revision spec (plain text)
ifc://interfaces/{interfaceId}/releases/{version}Release revision spec (plain text)

Guidance for agents ​

  1. Prefer resolve_interface_path when you know owner + slug.
  2. Validate with validate_spec before create_revision when the body may be invalid.
  3. Never skip elicitation for create_release.
  4. Use org-owned interfaces for shared work.

IFC7 interface hub