ai.filegraph/document-processing

{
  "checks": {
    "action_safety_probe": {
      "details": {
        "auth_present": false,
        "confirmation_signals": [],
        "safeguard_count": 2,
        "summary": {
          "bulk_access_tools": 0,
          "capability_distribution": {
            "delete": 1,
            "exec": 8,
            "filesystem": 9,
            "network": 8,
            "read": 9,
            "secrets": 1,
            "write": 1
          },
          "destructive_tools": 1,
          "egress_tools": 8,
          "exec_tools": 8,
          "high_risk_tools": 8,
          "risk_distribution": {
            "critical": 2,
            "high": 6,
            "low": 1,
            "medium": 0
          },
          "secret_tools": 1,
          "tool_count": 9
        }
      },
      "latency_ms": null,
      "status": "error"
    },
    "advanced_capabilities_probe": {
      "details": {
        "capabilities": {
          "completions": false,
          "elicitation": false,
          "prompts": true,
          "resource_links": false,
          "resources": true,
          "roots": false,
          "sampling": false,
          "structured_outputs": false
        },
        "enabled": [
          "prompts",
          "resources"
        ],
        "enabled_count": 2,
        "initialize_capability_keys": [
          "experimental",
          "prompts",
          "resources",
          "tasks",
          "tools"
        ]
      },
      "latency_ms": null,
      "status": "warning"
    },
    "connector_publishability_probe": {
      "details": {
        "blockers": [
          "action_safety",
          "server_card"
        ],
        "criteria": {
          "action_safety": false,
          "auth_flow": true,
          "connector_replay": true,
          "initialize": true,
          "protocol_version": true,
          "remote_transport": true,
          "request_association": true,
          "server_card": false,
          "session_resume": true,
          "step_up_auth": true,
          "tool_surface": true,
          "tools_list": true,
          "transport_compliance": true
        },
        "high_risk_tools": 8,
        "tool_count": 9,
        "transport": "sse"
      },
      "latency_ms": null,
      "status": "warning"
    },
    "connector_replay_probe": {
      "details": {
        "added_tools": [],
        "additive_output_changes": [],
        "backward_compatible": true,
        "output_breaks": [],
        "removed_tools": [],
        "required_arg_breaks": [],
        "would_break_after_refresh": false
      },
      "latency_ms": null,
      "status": "ok"
    },
    "determinism_probe": {
      "details": {
        "attempts": 2,
        "baseline_signature": "c39dada74d3d27728412fc666b9e2860ce238e19da9d45499bbbedbc7cd5c2e9",
        "errors": [],
        "matches": 2,
        "stable_ratio": 1.0,
        "successful": 2
      },
      "latency_ms": 336.19,
      "status": "ok"
    },
    "initialize": {
      "details": {
        "headers": {
          "content-type": "text/event-stream"
        },
        "http_status": 200,
        "payload": {
          "id": 1,
          "jsonrpc": "2.0",
          "result": {
            "capabilities": {
              "experimental": {},
              "prompts": {
                "listChanged": true
              },
              "resources": {
                "listChanged": true,
                "subscribe": false
              },
              "tasks": {
                "cancel": {},
                "list": {},
                "requests": {
                  "prompts": {
                    "get": {}
                  },
                  "resources": {
                    "read": {}
                  },
                  "tools": {
                    "call": {}
                  }
                }
              },
              "tools": {
                "listChanged": true
              }
            },
            "instructions": "FileGraph API documentation server.\n\nThis MCP server provides documentation about the FileGraph REST API.\nUse the context tools to learn about available endpoints, then write code that\ncalls the REST API directly using httpx, requests, curl, etc.\n\n## Available Tools\n\n- `filegraph_api_overview` \u2014 Auth, rate limits, errors, and a summary of all endpoint groups\n- `filegraph_text_extraction_docs` \u2014 /any/to-text, /any/info, /any/to-struct \u2014 extract text with smart format detection and ocr, analyze file metadata, extract structured data with LLM\n- `filegraph_pdf_text_conversion_docs` \u2014 /pdf/to-text, /pdf/to-docx, /pdf/to-image \u2014 extract text with ocr, convert pdf to docx or images\n- `filegraph_pdf_manipulation_docs` \u2014 /pdf/merge, /pdf/split, /pdf/compress, /pdf/rotate \u2014 merge, split, compress, and rotate pdf files\n- `filegraph_pdf_security_docs` \u2014 /pdf/encrypt, /pdf/decrypt \u2014 encrypt and decrypt pdf files with password protection\n- `filegraph_image_processing_docs` \u2014 /image/to-text, /image/to-pdf, /image/resize \u2014 extract text via ocr, convert images to pdf, resize images\n- `filegraph_office_documents_docs` \u2014 /docx/to-text, /docx/to-pdf, /xlsx/to-text, /xlsx/to-pdf, /xlsx/to-csv, /pptx/to-text, /pptx/to-pdf, /pptx/to-images \u2014 extract text/data, convert word/excel/powerpoint to pdf/csv/images\n- `filegraph_html_processing_docs` \u2014 /html/to-text, /html/to-pdf, /html/to-image \u2014 extract html text, render to pdf, capture html screenshots\n- `filegraph_security_docs` \u2014 /security/pdf/redact, /security/text/redact, /security/pdf/lock, /security/pdf/unlock, /security/detect-tracking \u2014 redact sensitive pdf content, redact PII from extracted text, lock/unlock pdfs, detect/remove tracking pixels\n\n## Workflow\n\n1. Start with `filegraph_api_overview` to understand auth and rate limits\n2. Call the relevant `_docs` tool for the endpoint group you need\n3. Write Python/curl/JavaScript code that calls the REST API\n4. The code should use the user's FILEGRAPH_API_KEY environment variable\n\n## Reducing Token Usage\n\nAll documentation tools accept an optional `endpoint` parameter to request docs\nfor a single endpoint rather than the entire category. Use this when you only\nneed one specific endpoint:\n\n```\nfilegraph_security_docs(endpoint=\"/security/pdf/redact\")\nfilegraph_pdf_operations_docs(endpoint=\"/pdf/merge\")\n```\n\nEach tool's description lists the valid endpoint values for that group.\n\n## Multi-Language Code Examples\n\nAll documentation tools accept an optional `language` parameter to get code\nexamples in your preferred language. If not specified, defaults to Python HTTPX.\n\nAvailable language keys:\n- `python_requests` \u2014 Python Requests\n- `python_httpx` \u2014 Python HTTPX (default)\n- `python_httpx_async` \u2014 Python HTTPX (Async)\n- `shell_curl` \u2014 Shell cURL\n- `js_fetch` \u2014 JavaScript Fetch\n- `node_fetch` \u2014 Node.js Fetch\n- `go_native` \u2014 Go\n- `ruby_native` \u2014 Ruby\n- `java_okhttp` \u2014 Java OkHttp\n- `csharp_httpclient` \u2014 C# HttpClient\n\n## Rate Limiting\n\nThe API has per-minute and per-day rate limits. Code examples include retry\nlogic with exponential backoff for handling 429 responses. For bulk operations,\nuse the batch processing patterns shown in the enriched examples (asyncio.gather\nfor Python, Promise.all for TypeScript, errgroup for Go).\n\n## Example\n\n```python\n# After reading filegraph_text_extraction_docs, you'd write:\nhttpx.post(\"https://api.filegraph.ai/any/to-text\",\n    headers={\n      \"X-API-Key\": \"YOUR_API_KEY\"\n    },\n    params={\n      \"ocr_language\": \"eng\",\n      \"ocr_fallback\": \"true\"\n    },\n    files=[\n      (\"file\", open(\"document.pdf\", \"rb\"))\n    ]\n)\n```\n\n## Base URL\n\nhttps://api.filegraph.ai\n\n## Get Your API Key\n\nVisit https://filegraph.ai/dashboard\n",
            "protocolVersion": "2025-03-26",
            "serverInfo": {
              "name": "FileGraph",
              "version": "2.14.5"
            }
          }
        },
        "url": "https://api.filegraph.ai/mcp"
      },
      "latency_ms": 574.99,
      "status": "ok"
    },
    "interactive_flow_probe": {
      "details": {
        "oauth_supported": false,
        "prompt_available": false,
        "risk_hits": [],
        "safe_hits": []
      },
      "latency_ms": null,
      "status": "missing"
    },
    "oauth_authorization_server": {
      "details": {
        "reason": "no_authorization_server"
      },
      "latency_ms": null,
      "status": "missing"
    },
    "oauth_protected_resource": {
      "details": {
        "error": "Client error '404 Not Found' for url 'https://api.filegraph.ai/.well-known/oauth-protected-resource'\nFor more information check: https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/404",
        "url": "https://api.filegraph.ai/.well-known/oauth-protected-resource"
      },
      "latency_ms": 277.9,
      "status": "error"
    },
    "official_registry_probe": {
      "details": {
        "direct_match": true,
        "official_peer_count": 1,
        "registry_identifier": "ai.filegraph/document-processing",
        "registry_source": "official_registry"
      },
      "latency_ms": null,
      "status": "ok"
    },
    "openid_configuration": {
      "details": {
        "reason": "no_authorization_server"
      },
      "latency_ms": null,
      "status": "missing"
    },
    "probe_noise_resilience": {
      "details": {
        "headers": {
          "content-type": "text/plain; charset=utf-8"
        },
        "http_status": 200,
        "url": "https://api.filegraph.ai/robots.txt"
      },
      "latency_ms": 294.2,
      "status": "ok"
    },
    "prompt_get": {
      "details": {
        "reason": "not_advertised"
      },
      "latency_ms": null,
      "status": "missing"
    },
    "prompts_list": {
      "details": {
        "headers": {
          "content-type": "text/event-stream"
        },
        "http_status": 200,
        "payload": {
          "id": 3,
          "jsonrpc": "2.0",
          "result": {
            "prompts": []
          }
        },
        "url": "https://api.filegraph.ai/mcp"
      },
      "latency_ms": 342.22,
      "status": "ok"
    },
    "protocol_version_probe": {
      "details": {
        "claimed_version": "2025-03-26",
        "lag_days": 244,
        "latest_known_version": "2025-11-25",
        "releases_behind": 2,
        "validator_protocol_version": "2025-03-26"
      },
      "latency_ms": null,
      "status": "warning"
    },
    "provenance_divergence_probe": {
      "details": {
        "direct_official_match": true,
        "drift_fields": [],
        "metadata_document_count": 1,
        "registry_homepage": null,
        "registry_repository": null,
        "registry_title": null,
        "registry_version": null,
        "server_card_homepage": null,
        "server_card_repository": null,
        "server_card_title": null,
        "server_card_version": null
      },
      "latency_ms": null,
      "status": "ok"
    },
    "request_association_probe": {
      "details": {
        "reason": "no_request_association_capabilities_advertised"
      },
      "latency_ms": null,
      "status": "missing"
    },
    "resource_read": {
      "details": {
        "reason": "not_advertised"
      },
      "latency_ms": null,
      "status": "missing"
    },
    "resources_list": {
      "details": {
        "headers": {
          "content-type": "text/event-stream"
        },
        "http_status": 200,
        "payload": {
          "id": 5,
          "jsonrpc": "2.0",
          "result": {
            "resources": []
          }
        },
        "url": "https://api.filegraph.ai/mcp"
      },
      "latency_ms": 339.04,
      "status": "ok"
    },
    "server_card": {
      "details": {
        "error": "Client error '404 Not Found' for url 'https://api.filegraph.ai/.well-known/mcp/server-card.json'\nFor more information check: https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/404",
        "url": "https://api.filegraph.ai/.well-known/mcp/server-card.json"
      },
      "latency_ms": 336.58,
      "status": "error"
    },
    "session_resume_probe": {
      "details": {
        "protocol_version": "2025-03-26",
        "reason": "no_session_id",
        "resume_expected": true,
        "transport": "sse"
      },
      "latency_ms": null,
      "status": "warning"
    },
    "step_up_auth_probe": {
      "details": {
        "auth_required_checks": [],
        "broad_scopes": [],
        "challenge_headers": [],
        "minimal_scope_documented": false,
        "oauth_present": false,
        "scope_specificity_ratio": 0.0,
        "step_up_signals": [],
        "supported_scopes": []
      },
      "latency_ms": null,
      "status": "missing"
    },
    "tool_snapshot_probe": {
      "details": {
        "added": [],
        "changed_outputs": [],
        "current_tool_count": 9,
        "previous_tool_count": 9,
        "removed": [],
        "similarity": 1.0
      },
      "latency_ms": null,
      "status": "ok"
    },
    "tools_list": {
      "details": {
        "headers": {
          "content-type": "text/event-stream"
        },
        "http_status": 200,
        "payload": {
          "id": 2,
          "jsonrpc": "2.0",
          "result": {
            "tools": [
              {
                "_meta": {
                  "_fastmcp": {
                    "tags": [
                      "Context"
                    ]
                  }
                },
                "description": "API overview: authentication, rate limits, errors, and available endpoint groups.",
                "inputSchema": {
                  "properties": {},
                  "required": [],
                  "type": "object"
                },
                "name": "filegraph_api_overview"
              },
              {
                "_meta": {
                  "_fastmcp": {
                    "tags": [
                      "Context"
                    ]
                  }
                },
                "description": "Docs for /any/to-text, /any/info, /any/to-struct \u2014 extract text with smart format detection and ocr, analyze file metadata, extract structured data with LLM.",
                "inputSchema": {
                  "properties": {
                    "endpoint": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Get docs for a single endpoint only (reduces response size). Valid values: /any/to-text, /any/info, /any/to-struct",
                      "title": "Endpoint"
                    },
                    "language": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Language for code examples (e.g. 'go_native', 'shell_curl'). Defaults to Python HTTPX.",
                      "title": "Language"
                    }
                  },
                  "required": [],
                  "type": "object"
                },
                "name": "filegraph_text_extraction_docs"
              },
              {
                "_meta": {
                  "_fastmcp": {
                    "tags": [
                      "Context"
                    ]
                  }
                },
                "description": "Docs for /pdf/to-text, /pdf/to-docx, /pdf/to-image \u2014 extract text with ocr, convert pdf to docx or images.",
                "inputSchema": {
                  "properties": {
                    "endpoint": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Get docs for a single endpoint only (reduces response size). Valid values: /pdf/to-text, /pdf/to-docx, /pdf/to-image",
                      "title": "Endpoint"
                    },
                    "language": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Language for code examples (e.g. 'go_native', 'shell_curl'). Defaults to Python HTTPX.",
                      "title": "Language"
                    }
                  },
                  "required": [],
                  "type": "object"
                },
                "name": "filegraph_pdf_text_conversion_docs"
              },
              {
                "_meta": {
                  "_fastmcp": {
                    "tags": [
                      "Context"
                    ]
                  }
                },
                "description": "Docs for /pdf/merge, /pdf/split, /pdf/compress, /pdf/rotate \u2014 merge, split, compress, and rotate pdf files.",
                "inputSchema": {
                  "properties": {
                    "endpoint": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Get docs for a single endpoint only (reduces response size). Valid values: /pdf/merge, /pdf/split, /pdf/compress, /pdf/rotate",
                      "title": "Endpoint"
                    },
                    "language": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Language for code examples (e.g. 'go_native', 'shell_curl'). Defaults to Python HTTPX.",
                      "title": "Language"
                    }
                  },
                  "required": [],
                  "type": "object"
                },
                "name": "filegraph_pdf_manipulation_docs"
              },
              {
                "_meta": {
                  "_fastmcp": {
                    "tags": [
                      "Context"
                    ]
                  }
                },
                "description": "Docs for /pdf/encrypt, /pdf/decrypt \u2014 encrypt and decrypt pdf files with password protection.",
                "inputSchema": {
                  "properties": {
                    "endpoint": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Get docs for a single endpoint only (reduces response size). Valid values: /pdf/encrypt, /pdf/decrypt",
                      "title": "Endpoint"
                    },
                    "language": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Language for code examples (e.g. 'go_native', 'shell_curl'). Defaults to Python HTTPX.",
                      "title": "Language"
                    }
                  },
                  "required": [],
                  "type": "object"
                },
                "name": "filegraph_pdf_security_docs"
              },
              {
                "_meta": {
                  "_fastmcp": {
                    "tags": [
                      "Context"
                    ]
                  }
                },
                "description": "Docs for /image/to-text, /image/to-pdf, /image/resize \u2014 extract text via ocr, convert images to pdf, resize images.",
                "inputSchema": {
                  "properties": {
                    "endpoint": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Get docs for a single endpoint only (reduces response size). Valid values: /image/to-text, /image/to-pdf, /image/resize",
                      "title": "Endpoint"
                    },
                    "language": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Language for code examples (e.g. 'go_native', 'shell_curl'). Defaults to Python HTTPX.",
                      "title": "Language"
                    }
                  },
                  "required": [],
                  "type": "object"
                },
                "name": "filegraph_image_processing_docs"
              },
              {
                "_meta": {
                  "_fastmcp": {
                    "tags": [
                      "Context"
                    ]
                  }
                },
                "description": "Docs for /docx/to-text, /docx/to-pdf, /xlsx/to-text, /xlsx/to-pdf, /xlsx/to-csv, /pptx/to-text, /pptx/to-pdf, /pptx/to-images \u2014 extract text/data, convert word/excel/powerpoint to pdf/csv/images.",
                "inputSchema": {
                  "properties": {
                    "endpoint": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Get docs for a single endpoint only (reduces response size). Valid values: /docx/to-text, /docx/to-pdf, /xlsx/to-text, /xlsx/to-pdf, /xlsx/to-csv, /pptx/to-text, /pptx/to-pdf, /pptx/to-images",
                      "title": "Endpoint"
                    },
                    "language": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Language for code examples (e.g. 'go_native', 'shell_curl'). Defaults to Python HTTPX.",
                      "title": "Language"
                    }
                  },
                  "required": [],
                  "type": "object"
                },
                "name": "filegraph_office_documents_docs"
              },
              {
                "_meta": {
                  "_fastmcp": {
                    "tags": [
                      "Context"
                    ]
                  }
                },
                "description": "Docs for /html/to-text, /html/to-pdf, /html/to-image \u2014 extract html text, render to pdf, capture html screenshots.",
                "inputSchema": {
                  "properties": {
                    "endpoint": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Get docs for a single endpoint only (reduces response size). Valid values: /html/to-text, /html/to-pdf, /html/to-image",
                      "title": "Endpoint"
                    },
                    "language": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Language for code examples (e.g. 'go_native', 'shell_curl'). Defaults to Python HTTPX.",
                      "title": "Language"
                    }
                  },
                  "required": [],
                  "type": "object"
                },
                "name": "filegraph_html_processing_docs"
              },
              {
                "_meta": {
                  "_fastmcp": {
                    "tags": [
                      "Context"
                    ]
                  }
                },
                "description": "Docs for /security/pdf/redact, /security/text/redact, /security/pdf/lock, /security/pdf/unlock, /security/detect-tracking \u2014 redact sensitive pdf content, redact PII from extracted text, lock/unlock pdfs, detect/remove tracking pixels.",
                "inputSchema": {
                  "properties": {
                    "endpoint": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Get docs for a single endpoint only (reduces response size). Valid values: /security/pdf/redact, /security/text/redact, /security/pdf/lock, /security/pdf/unlock, /security/detect-tracking",
                      "title": "Endpoint"
                    },
                    "language": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Language for code examples (e.g. 'go_native', 'shell_curl'). Defaults to Python HTTPX.",
                      "title": "Language"
                    }
                  },
                  "required": [],
                  "type": "object"
                },
                "name": "filegraph_security_docs"
              }
            ]
          }
        },
        "url": "https://api.filegraph.ai/mcp"
      },
      "latency_ms": 341.77,
      "status": "ok"
    },
    "transport_compliance_probe": {
      "details": {
        "bad_protocol_error": null,
        "bad_protocol_headers": {
          "content-type": "application/json"
        },
        "bad_protocol_payload": {
          "error": {
            "code": -32600,
            "message": "Bad Request: Unsupported protocol version: 1999-99-99. Supported versions: 2024-11-05, 2025-03-26, 2025-06-18, 2025-11-25"
          },
          "id": "server-error",
          "jsonrpc": "2.0"
        },
        "bad_protocol_status_code": 400,
        "delete_error": null,
        "delete_status_code": null,
        "expired_session_error": null,
        "expired_session_status_code": null,
        "issues": [
          "missing_session_id",
          "missing_protocol_header"
        ],
        "last_event_id_visible": false,
        "protocol_header_present": false,
        "requested_protocol_version": "2025-03-26",
        "session_id_present": false,
        "transport": "sse"
      },
      "latency_ms": 256.25,
      "status": "warning"
    },
    "utility_coverage_probe": {
      "details": {
        "completions": {
          "advertised": false,
          "live_probe": "not_executed",
          "sample_target": null
        },
        "initialize_capability_keys": [
          "experimental",
          "prompts",
          "resources",
          "tasks",
          "tools"
        ],
        "pagination": {
          "metadata_signal": false,
          "next_cursor_methods": [],
          "supported": false
        },
        "tasks": {
          "advertised": true,
          "http_status": 200,
          "probe_status": "ok"
        }
      },
      "latency_ms": 235.47,
      "status": "ok"
    }
  },
  "failures": {
    "oauth_authorization_server": {
      "reason": "no_authorization_server"
    },
    "oauth_protected_resource": {
      "error": "Client error '404 Not Found' for url 'https://api.filegraph.ai/.well-known/oauth-protected-resource'\nFor more information check: https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/404",
      "url": "https://api.filegraph.ai/.well-known/oauth-protected-resource"
    },
    "openid_configuration": {
      "reason": "no_authorization_server"
    },
    "server_card": {
      "error": "Client error '404 Not Found' for url 'https://api.filegraph.ai/.well-known/mcp/server-card.json'\nFor more information check: https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/404",
      "url": "https://api.filegraph.ai/.well-known/mcp/server-card.json"
    }
  },
  "remote_url": "https://api.filegraph.ai/mcp",
  "server_card_payload": null,
  "server_identifier": "ai.filegraph/document-processing"
}