Document how to use the Ontos MCP server with Genie
Nobody has claimed this yet.
Assessment
- Difficulty
- 2/5
- Estimated time
- 1-2 days
- Newbie friendliness
- 84/100
- Issue type
- Documentation
- Clarity
- Clearly specified
- Activity status
- Active
- Tech stack
- python
- Domain
- documentation
Research direction
Start with docs/handbook/mcp-and-ask-ontos.md and inspect routes/mcp_routes.py for the /api/mcp endpoint and exposed tools. Document MCP token creation, least-privilege scopes, endpoint registration, and a Genie example covering token, registration, and a sample tool call. Done means a reviewer can follow the guide using a live MCP token.
Written by the indexing model from the issue text.
Description
Part of the "Large-account scale, async importers, and UC domain sync" epic. PRD: docs/prds/prd-large-account-scale-and-uc-sync.md.
Problem statement
The Ontos MCP server (routes/mcp_routes.py, POST /api/mcp) exposes tools and the handbook (docs/handbook/mcp-and-ask-ontos.md) explains Ask Ontos vs MCP conceptually, but there is no concrete guide to connect Genie / an external agent: token creation, scopes, endpoint registration, or a worked example.
Proposed Solution
Extend docs/handbook/mcp-and-ask-ontos.md (or a focused sibling it links) with: creating an MCP token in Settings → MCP Tokens, a scope-to-use-case table (least privilege), registering the /api/mcp endpoint, and a Genie-specific worked example (token → registration → sample tool call). Docs-only.
Additional Context
No API/tool/scope changes. If the worked example reveals a missing scope or ergonomics gap, file that separately. Validation is a reviewer walking the guide against a live MCP token.
- Dominant language
- Python
- Stars
- 212
- Forks
- 71
- Avg merge
- 4d 10h
- Merged PRs (30d)
- 43
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from databrickslabs/ontos
-
source/external-request stakeholder/fpiz tech/build type/bug
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
databrickslabs/ontos#829 ·
-
scope/ontology tech/javascript type/bug
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
databrickslabs/ontos#686 · 2 comments ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
databrickslabs/ontos#678 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
databrickslabs/ontos#665 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
databrickslabs/ontos#594 ·
All issues in databrickslabs/ontos
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
-
enhancement
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 74/100