Developers

MCP server

Model Context Protocol server. Connect Claude, GPT, or any MCP-aware AI to the TradeForm Knowledge Base — for reading, and for authoring.

Connect from Claude.ai / Cowork

In your Claude.ai or Cowork client, go to Settings → Connectors, choose Add custom MCP, and paste:

URL:    https://knowledge.tradeform.au/api/mcp
Header: Authorization: Bearer tfk_xxxxxxxxxxxxxxxxxxxx

Use an internal-tier API key (issued from /admin/api-keys). Read tools work without a key; write tools require one.

Once connected, Claude can directly: research a topic from primary sources, draft an entry in TradeForm voice, lint its own work, save the draft to the KB, and submit for your review — all from chat.

Connect from Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "tradeform-knowledge": {
      "url": "https://knowledge.tradeform.au/api/mcp",
      "headers": { "Authorization": "Bearer tfk_..." }
    }
  }
}

Restart Claude Desktop. The TradeForm tools appear in the tool picker.

Read tools no auth

search_knowledge

Hybrid search (FTS + vector). Args: query, jurisdiction?, topic?, limit?.

get_entry

Fetch a single entry by slug. Args: slug, version?.

get_rag_chunks

Top-K chunks for grounding an answer. Args: query, k?, jurisdiction?, topic?.

list_topics

Full taxonomy (level-1 + subtopics).

list_jurisdictions

All AU jurisdictions covered.

list_reviewers

Named reviewers and their qualifications.

get_recent_changes

Recent publish/update events. Args: since?.

Write tools internal key required

pick_backlog_item

Suggest the next backlog item to draft. Filters by topic + jurisdiction.

get_research_for_topic

Fetch primary-source excerpts before drafting. ALWAYS call this first.

create_draft

Create a new draft entry. At least one citation required.

update_draft

Iterate on an existing draft. Cannot modify a published entry.

lint_draft_preview

Run the mechanical linter without saving — self-check em dashes, AI tells, copyright, slug format.

submit_for_review

Mark a draft ready for human review (transitions status to in_review).

list_my_drafts

List your current drafts and in-review entries.

Suggested authoring flow when Claude has the write tools:

Call pick_backlog_item (or the user names a topic).
Call get_research_for_topic to fetch primary-source excerpts.
Draft in markdown, paraphrasing from those excerpts, citing each by URL.
Call lint_draft_preview to self-check.
Fix anything the linter flags. Repeat lint until clean.
Call create_draft with the full payload.
Call submit_for_review when ready.

Resources

kb://topics
kb://jurisdictions
kb://entry/{slug}
kb://reviewer/{slug}