DiffiCat · OpenAPI Overlay 1.0.0

DiffiCat Agent API - API Evangelist enhancements

18 actions 18 updates documentation extends ../openapi/_original/difficat-com-openapi.yml
Derived by API Evangelist Built from the contracts DiffiCat publishes. DiffiCat did not publish this file.
View Overlay File View on GitHub Overlay Specification

What the actions change

tagsx-mcp-toolsx-mcp-server

Targets 18 · first 16 shown; the file carries all of them

$
$.paths['/discover'].post
$.paths['/screenshots'].post
$.paths['/jobs'].post
$.paths['/jobs'].get
$.paths['/balance'].get
$.paths['/feedback'].post
$.paths['/jobs/recover'].post
$.paths['/jobs/{id}'].get
$.paths['/jobs/{id}/report'].get
$.paths['/jobs/{id}/files/{filename}'].get
$.paths['/jobs/{id}/cancel'].post
$.paths['/snapshots'].get
$.paths['/snapshots/{id}'].get
$.paths['/snapshots/{id}/pages/{n}'].get
$.paths['/snapshots/{id}/files/{filename}'].get

OpenAPI Overlay

Raw ↑ 
overlay: 1.0.0
info:
  title: DiffiCat Agent API - API Evangelist enhancements
  version: 1.0.0
  x-provenance:
    generated: '2026-11-05'
    method: derived
    source: mcp/difficat-com-tool-crosswalk.yml
extends: ../openapi/_original/difficat-com-openapi.yml
actions:
- target: $
  description: Record the official hosted MCP server that fronts this API.
  update:
    x-mcp-server:
      endpoint: https://app.difficat.com/mcp
      full_surface: https://app.difficat.com/mcp?surface=full
      transport: streamable-http
      registry: com.difficat/difficat
- target: $.paths['/discover'].post
  description: Tag discoverPages and record the MCP tool(s) that invoke it (derived from the live tools/list).
  update:
    x-mcp-tools:
    - discover_pages
    tags:
    - Discovery
- target: $.paths['/screenshots'].post
  description: Tag captureScreenshot and record the MCP tool(s) that invoke it (derived from the live tools/list).
  update:
    x-mcp-tools:
    - capture_screenshot
    tags:
    - Screenshots
- target: $.paths['/jobs'].post
  description: Tag startComparison and record the MCP tool(s) that invoke it (derived from the live tools/list).
  update:
    x-mcp-tools:
    - start_comparison
    tags:
    - Comparison
- target: $.paths['/jobs'].get
  description: Tag listJobs and record the MCP tool(s) that invoke it (derived from the live tools/list).
  update:
    tags:
    - Billing
- target: $.paths['/balance'].get
  description: Tag getBalance and record the MCP tool(s) that invoke it (derived from the live tools/list).
  update:
    x-mcp-tools:
    - get_balance
    tags:
    - Billing
- target: $.paths['/feedback'].post
  description: Tag sendFeedback and record the MCP tool(s) that invoke it (derived from the live tools/list).
  update:
    x-mcp-tools:
    - send_feedback
    tags:
    - Feedback
- target: $.paths['/jobs/recover'].post
  description: Tag recoverComparison and record the MCP tool(s) that invoke it (derived from the live tools/list).
  update:
    x-mcp-tools:
    - recover_comparison
    tags:
    - Comparison
- target: $.paths['/jobs/{id}'].get
  description: Tag getComparison and record the MCP tool(s) that invoke it (derived from the live tools/list).
  update:
    x-mcp-tools:
    - get_comparison
    - wait_for_comparison
    tags:
    - Comparison
- target: $.paths['/jobs/{id}/report'].get
  description: Tag getReport and record the MCP tool(s) that invoke it (derived from the live tools/list).
  update:
    x-mcp-tools:
    - get_report
    tags:
    - Reports
- target: $.paths['/jobs/{id}/files/{filename}'].get
  description: Tag getScreenshot and record the MCP tool(s) that invoke it (derived from the live tools/list).
  update:
    x-mcp-tools:
    - get_screenshot
    tags:
    - Reports
- target: $.paths['/jobs/{id}/cancel'].post
  description: Tag cancelComparison and record the MCP tool(s) that invoke it (derived from the live tools/list).
  update:
    x-mcp-tools:
    - cancel_comparison
    tags:
    - Comparison
- target: $.paths['/snapshots'].get
  description: Tag listSnapshots and record the MCP tool(s) that invoke it (derived from the live tools/list).
  update:
    x-mcp-tools:
    - list_snapshots
    tags:
    - Snapshots
- target: $.paths['/snapshots/{id}'].get
  description: Tag getSnapshot and record the MCP tool(s) that invoke it (derived from the live tools/list).
  update:
    x-mcp-tools:
    - get_snapshot
    tags:
    - Snapshots
- target: $.paths['/snapshots/{id}/pages/{n}'].get
  description: Tag getSnapshotPage and record the MCP tool(s) that invoke it (derived from the live tools/list).
  update:
    x-mcp-tools:
    - get_snapshot
    tags:
    - Snapshots
- target: $.paths['/snapshots/{id}/files/{filename}'].get
  description: Tag getSnapshotFile and record the MCP tool(s) that invoke it (derived from the live tools/list).
  update:
    x-mcp-tools:
    - get_snapshot
    tags:
    - Snapshots
- target: $.paths['/snapshots/{id}/compare'].post
  description: Tag compareSnapshotLive and record the MCP tool(s) that invoke it (derived from the live tools/list).
  update:
    x-mcp-tools:
    - compare_snapshot
    tags:
    - Snapshots
- target: $.paths['/compares'].post
  description: Tag compareSnapshots and record the MCP tool(s) that invoke it (derived from the live tools/list).
  update:
    x-mcp-tools:
    - compare_snapshot
    tags:
    - Snapshots

Work with this as data

Every overlay here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for openapi overlays

4 MCP tools reach this
  • find_overlaysBrowse and filter every overlay in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This overlay 
curl "https://apis.io/api/v1/overlays/difficat-com-agent-api-overlay"
All openapi overlays 
curl "https://apis.io/api/v1/overlays?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.