openaccountants/openaccountants

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": true,
    "title": "List tax & accounting skills"
  },
  "capabilities": [
    "read",
    "network",
    "admin"
  ],
  "input_schema": {
    "properties": {
      "category": {
        "description": "(Legacy) display label; prefer domain/role.",
        "type": "string"
      },
      "domain": {
        "description": "Filter by accounting domain: income-tax, vat-gst, payroll, bookkeeping, e-invoicing, formation, financial-statements, transfer-pricing, tax-optimization, crypto, cross-border, corporate-tax, estate-wealth-tax, references, sector-guidance, tooling.",
        "type": "string"
      },
      "jurisdiction": {
        "description": "Filter by jurisdiction code, e.g. 'US', 'MT', 'DE'",
        "type": "string"
      },
      "limit": {
        "description": "Max skills to return (default 100, max 200).",
        "type": "integer"
      },
      "offset": {
        "description": "Number of skills to skip \u2014 use the next_offset from the previous response to page through results (default 0).",
        "type": "integer"
      },
      "role": {
        "description": "Filter by pipeline role: foundation, compute, orchestrator, reference.",
        "type": "string"
      }
    },
    "type": "object"
  },
  "risk_flags": [
    "arbitrary_network_egress",
    "freeform_input_surface"
  ]
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": true,
    "title": "Get a tax skill"
  },
  "capabilities": [
    "read"
  ],
  "input_schema": {
    "properties": {
      "reason": {
        "description": "One sentence on WHY you're making this call, in the user's terms (for routing analysis only). Optional.",
        "type": "string"
      },
      "slug": {
        "description": "Skill slug, e.g. 'us-schedule-c-and-se-computation'",
        "type": "string"
      }
    },
    "required": [
      "slug"
    ],
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": true,
    "title": "Get a skill's sections"
  },
  "capabilities": [
    "read"
  ],
  "input_schema": {
    "properties": {
      "section_index": {
        "description": "Optional. Return only this section (matches the `index` from get_skill's `section_index`).",
        "type": "integer"
      },
      "section_indices": {
        "description": "Optional. Return only these sections.",
        "items": {
          "type": "integer"
        },
        "type": "array"
      },
      "slug": {
        "description": "Skill slug",
        "type": "string"
      }
    },
    "required": [
      "slug"
    ],
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": true,
    "title": "Search skills by keyword"
  },
  "capabilities": [
    "read",
    "network"
  ],
  "input_schema": {
    "properties": {
      "content_type": {
        "description": "What kind of Guide to find. 'method' = step-by-step procedures you EXECUTE via start() (formerly 'workflows'); 'fact' or omitted = reference material (rates/thresholds/rules). A Guide can be either or both.",
        "enum": [
          "method",
          "fact"
        ],
        "type": "string"
      },
      "domain": {
        "description": "Optional accounting domain to limit the search (e.g. 'vat-gst', 'payroll', 'income-tax', 'crypto').",
        "type": "string"
      },
      "jurisdiction": {
        "description": "Optional ISO 2-letter country code to limit the search",
        "type": "string"
      },
      "query": {
        "description": "Search term, e.g. 'home office deduction', 'crypto capital gains', 'reverse charge'. With content_type='method', a broad term (or the domain word) lists the available methods.",
        "type": "string"
      }
    },
    "required": [
      "query"
    ],
    "type": "object"
  },
  "risk_flags": [
    "arbitrary_network_egress",
    "freeform_input_surface"
  ]
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": true,
    "title": "Search rules across jurisdictions"
  },
  "capabilities": [
    "read"
  ],
  "input_schema": {
    "properties": {
      "block_types": {
        "description": "Rule kinds to include. Default = all of these (framing prose + workflow steps are excluded).",
        "items": {
          "enum": [
            "rate",
            "threshold",
            "rule",
            "formula",
            "refusal_code",
            "definition",
            "table_ref",
            "table"
          ],
          "type": "string"
        },
        "type": "array"
      },
      "domains": {
        "description": "Accounting domains, e.g. ['vat-gst','income-tax']. See list_rule_facets.",
        "items": {
          "type": "string"
        },
        "type": "array"
      },
      "jurisdictions": {
        "description": "ISO codes to include, e.g. ['MT','US-CA']. Omit for all jurisdictions.",
        "items": {
          "type": "string"
        },
        "type": "array"
      },
      "limit": {
        "description": "Max rules to return (default 200, max 500).",
        "type": "integer"
      },
      "offset": {
        "description": "Pagination offset \u2014 pass the previous response's next_offset.",
        "type": "integer"
      },
      "reason": {
        "description": "One sentence on WHY you're making this call, in the user's terms (for routing analysis only). Optional.",
        "type": "string"
      },
      "roles": {
        "description": "Skill roles: foundation | compute | orchestrator | reference.",
        "items": {
          "type": "string"
        },
        "type": "array"
      },
      "status": {
        "description": "Shorthand for `statuses`: 'verified' = accountant- + research-verified only. Default 'all'.",
        "enum": [
          "all",
          "verified"
        ],
        "type": "string"
      },
      "statuses": {
        "description": "Verification statuses to include. Default = all (each rule is tagged).",
        "items": {
          "enum": [
            "draft",
            "research_verified",
            "accountant_verified",
            "needs_update",
            "unsure"
          ],
          "type": "string"
        },
        "type": "array"
      },
      "tax_year": {
        "description": "Limit to a tax year, e.g. 2025.",
        "type": "integer"
      },
      "text": {
        "description": "Free-text search over each rule's label, value, and citation.",
        "type": "string"
      },
      "topic": {
        "description": "Filter by a fact topic.",
        "type": "string"
      }
    },
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": true,
    "title": "Upcoming tax deadlines for a jurisdiction"
  },
  "capabilities": [
    "read",
    "network"
  ],
  "input_schema": {
    "properties": {
      "horizon_days": {
        "description": "How far ahead to look (default 120, max 366).",
        "type": "integer"
      },
      "jurisdiction": {
        "description": "ISO code, slug, or name ('MT', 'US-CA', 'Malta'). Optional for signed-in users with a saved home jurisdiction.",
        "type": "string"
      }
    },
    "type": "object"
  },
  "risk_flags": [
    "arbitrary_network_egress"
  ]
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": true,
    "title": "List queryable rule facets (no args)"
  },
  "capabilities": [
    "read"
  ],
  "input_schema": {
    "properties": {},
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": true,
    "title": "Get tax-workflow scoping guidance (no args)"
  },
  "capabilities": [
    "read"
  ],
  "input_schema": {
    "properties": {},
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": true,
    "title": "Start a tax workflow"
  },
  "capabilities": [
    "read",
    "network"
  ],
  "input_schema": {
    "properties": {
      "acting_as": {
        "description": "REQUIRED. Who the user is: 'self' = a taxpayer handling their OWN taxes; 'client' = a professional (accountant/advisor) working on behalf of a CLIENT. Establish this before calling \u2014 if it isn't clear from the conversation, ask the user one short question ('Are these your own taxes, or are you helping a client?'). Never guess.",
        "enum": [
          "self",
          "client"
        ],
        "type": "string"
      },
      "intent": {
        "description": "User intent \u2014 REQUIRED. Free text, e.g. 'taxes', 'VAT return', 'set up a company'.",
        "type": "string"
      },
      "jurisdiction": {
        "description": "ISO 2-letter code or US state code (e.g. 'MT', 'GB', 'US-CA').",
        "type": "string"
      },
      "reason": {
        "description": "One sentence, in the user's own words, on what they actually asked for here \u2014 captured only to improve routing. E.g. 'user sold ETH and wants to know what to report'. Optional but helpful.",
        "type": "string"
      },
      "taxpayer_type": {
        "description": "The taxpayer's occupation, when known. Some return-prep workflows fork by it (an employee's Form 1040 is a different guide from a freelancer's). Pass it if the conversation already makes it clear; otherwise omit \u2014 start() only asks for it (status:'needs_clarification', needs:['taxpayer_type']) when the guides for this jurisdiction/intent genuinely split by occupation. 'employee' = W-2 wages only; 'self-employed' = freelance / 1099 / sole-proprietor; 'both' = employed AND self-employed; 'company' = a corporate entity. Don't guess \u2014 ask the user one short question if unsure.",
        "enum": [
          "employee",
          "self-employed",
          "both",
          "company",
          "other"
        ],
        "type": "string"
      }
    },
    "required": [
      "intent"
    ],
    "type": "object"
  },
  "risk_flags": [
    "arbitrary_network_egress"
  ]
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": true,
    "title": "List all jurisdictions covered"
  },
  "capabilities": [
    "read"
  ],
  "input_schema": {
    "properties": {},
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": true,
    "title": "List named accountant verifiers"
  },
  "capabilities": [
    "read",
    "network"
  ],
  "input_schema": {
    "properties": {
      "jurisdiction": {
        "description": "Optional ISO code filter \u2014 only return verifiers for this jurisdiction.",
        "type": "string"
      }
    },
    "type": "object"
  },
  "risk_flags": [
    "arbitrary_network_egress"
  ]
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": true,
    "readOnlyHint": true,
    "title": "Validate an EU VAT number (live VIES lookup)"
  },
  "capabilities": [
    "read",
    "network"
  ],
  "input_schema": {
    "properties": {
      "country_code": {
        "description": "2-letter EU member-state code of the VAT number, e.g. 'DE', 'IE', 'FR'. Use 'EL' for Greece and 'XI' for Northern Ireland. May be omitted if the country prefix is already part of vat_number.",
        "type": "string"
      },
      "vat_number": {
        "description": "The VAT number, with or without the country prefix and spaces, e.g. 'IE6388047V', 'IE 6388047V', or '6388047V'.",
        "type": "string"
      }
    },
    "required": [
      "vat_number"
    ],
    "type": "object"
  },
  "risk_flags": [
    "arbitrary_network_egress",
    "freeform_input_surface"
  ]
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": true,
    "title": "Check statutory audit exemption"
  },
  "capabilities": [
    "read",
    "network"
  ],
  "input_schema": {
    "properties": {
      "balance_sheet_total": {
        "description": "Total assets at the balance sheet date.",
        "type": "number"
      },
      "currency": {
        "description": "Currency of the figures \u2014 must match the regime (EUR for MT, GBP for GB); convert first, never guess a rate.",
        "type": "string"
      },
      "employees_average": {
        "description": "Average number of employees during the year.",
        "type": "number"
      },
      "entity_type": {
        "description": "Optional. 'private_ltd' (default), 'plc', 'branch'. Non-private shapes route to a human.",
        "type": "string"
      },
      "financial_year_end": {
        "description": "ISO date the financial year ends, e.g. '2025-12-31'.",
        "type": "string"
      },
      "group_member": {
        "description": "Optional. True if the company is part of a group \u2014 group thresholds need a reviewer, so this forces 'review'.",
        "type": "boolean"
      },
      "jurisdiction": {
        "description": "ISO-style code. MT and GB supported today.",
        "type": "string"
      },
      "prior_year": {
        "description": "Prior-year figures for the two-consecutive-years test.",
        "properties": {
          "balance_sheet_total": {
            "type": "number"
          },
          "employees_average": {
            "type": "number"
          },
          "turnover": {
            "type": "number"
          }
        },
        "type": "object"
      },
      "turnover": {
        "description": "Revenue/turnover for the year, in the jurisdiction's currency.",
        "type": "number"
      }
    },
    "required": [
      "jurisdiction",
      "financial_year_end",
      "turnover",
      "balance_sheet_total",
      "employees_average",
      "currency"
    ],
    "type": "object"
  },
  "risk_flags": [
    "arbitrary_network_egress"
  ]
}

{
  "annotations": {
    "destructiveHint": true,
    "idempotentHint": false,
    "openWorldHint": false,
    "readOnlyHint": false,
    "title": "Share this with OpenAccountants"
  },
  "capabilities": [
    "write",
    "delete",
    "network"
  ],
  "input_schema": {
    "properties": {
      "contact_email": {
        "description": "Review only, REQUIRED when request_review: the user's email. Ask for it first.",
        "type": "string"
      },
      "contact_name": {
        "description": "Review only: the user's name.",
        "type": "string"
      },
      "jurisdiction": {
        "description": "Review only: ISO code or slug for the user's tax jurisdiction (e.g. 'US-CA').",
        "type": "string"
      },
      "note": {
        "description": "Anonymized improvement note: what the guidance covered vs what you added or worked around and why, or a bug in a specific skill. No names, amounts, or PII.",
        "type": "string"
      },
      "request_review": {
        "description": "true only when the user has asked for a licensed accountant to review their figures. Requires working_paper + jurisdiction + scenario + contact_email. Omit/false = just the note.",
        "type": "boolean"
      },
      "scenario": {
        "description": "Review only: brief description of the situation to review.",
        "type": "string"
      },
      "skill_slug": {
        "description": "Optional: set when the note is feedback about a SPECIFIC skill (e.g. 'us-sales-tax'). Replaces the old submit_feedback.",
        "type": "string"
      },
      "tax_year": {
        "description": "Review only: tax year, if relevant.",
        "type": "integer"
      },
      "working_paper": {
        "description": "Review only: the COMPLETE working paper markdown \u2014 every line item and assumption, not a summary.",
        "type": "string"
      }
    },
    "required": [
      "note"
    ],
    "type": "object"
  },
  "risk_flags": [
    "destructive_operation",
    "arbitrary_network_egress"
  ]
}

• For each high-risk tool (delete, exec, or network-egress capable), add a `confirm`/`dry_run` parameter or a two-step confirmation flow.
• Document the safeguard in the tool's description so clients and agents know confirmation is required before execution.
• Revalidate and confirm `action_safety_probe` reports the safeguard as detected.

• Return `Mcp-Session-Id` and `Mcp-Protocol-Version` headers consistently on streamable HTTP responses.
• Honor `DELETE` session teardown and return `404` when a deleted session is reused.
• Reject invalid protocol-version headers with `400 Bad Request`.

• Only send `roots/list`, `sampling/createMessage`, or `elicitation/create` requests while handling an active client-initiated request.
• Avoid emitting these requests on idle or newly-initialized sessions with no pending client request.
• Revalidate and confirm `request_association_probe` no longer returns `missing` or `warning`.

• Update the server's advertised protocol version to a current MCP revision (2025-06-18 or later).
• Return the negotiated version consistently in both the `initialize` response and the `MCP-Protocol-Version` header.
• Revalidate and confirm `protocol_version_probe` reports `ok`.

• Review the blockers and failed criteria recorded by connector_publishability_probe.
• Correct the identified transport, authentication, server-card, or tool-stability gaps.
• Revalidate and require the probe to report no blockers before publishing the connector.

• Advertise the narrowest viable scopes in OAuth metadata.
• Return `WWW-Authenticate` challenges with scope or insufficient-scope hints when additional consent is needed.
• Revalidate with both public discovery and auth-required flows.

• Serve `/.well-known/openid-configuration` with `issuer`, `jwks_uri`, `authorization_endpoint`, and `token_endpoint`.
• List supported grant types in `grant_types_supported` and scopes in `scopes_supported`.
• Revalidate and confirm the `openid_configuration` check returns `ok`.

• Only advertise resources with stable URIs and read semantics.
• Add MIME/type hints where possible.
• Run a live `resources/list` and `resources/read` check after updates.

• Advertise `completions`, pagination cursors, and `tasks` only when they are actually supported.
• Return `nextCursor` on large list operations when pagination is available.
• Document task support and whether it requires step-up auth.

• Add the capabilities you actually support (`roots`, `sampling`, `elicitation`) to the `capabilities` object returned from `initialize`.
• Only advertise a capability once the corresponding request/response flow is implemented end to end.
• Revalidate and confirm `advanced_capabilities_probe` reflects the updated capability set.

• Locate or create the canonical entry in the official MCP registry.
• Publish the live MCP endpoint and reconcile its repository and homepage metadata.
• Revalidate and confirm official_registry_probe recognizes the reconciled entry.

• Compare the initialize result's instructions field with the current tools/list names.
• Rename the explicit reference or restore the missing tool.
• Revalidate and confirm instruction_tool_reference_probe reports ok.