Documentation
MCP server
Connect Claude Code or any MCP client to your voice, with endpoints, tools, scopes, costs, and catalog settings.
Cost per action
Kaneme writes in your tool: no quota, 3 credits per text, for every format and channel.
Compact voice in your tool: your model writes, with 10 free portages per month for each account or Business seat, then 1 credit per call. One call = one portage.
10 credits and 10 free portages each month on Free and Credits accounts. Reset on your signup anniversary day, without rollover; the allowance is spent before purchased credits.
Grant a Kaneme account a Measure or Measure and write visa. The actor pays. The owner sees who, when, which action and which verdict, never the text, and can revoke access at any time. Only the owner publishes a certificate. A visa does not replace the OAuth voice:measure scope.
The surface, counted
- Tools, full catalog
- 43
- Core catalog
- 32
- Without an account
- 2
- Clients with a setup guide
- 11
- Transport
- streamable HTTP
Paste one address. Kaneme handles the handshake.
Add this remote MCP server to your client. It opens Kaneme sign-in, shows the exact permissions, and returns you to the conversation.
Endpoint (streamable HTTP)
Try it before you connect an account
The public endpoint exposes 2 free tools: read_observatory_signals and measure_authorship. It doesn’t store the reference writing you submit.
Public endpoint
Access conditions, tool by tool
Every tool uses an MCP client. The Kaneme account, authorization, and data sent then depend on the tool: the two public tools need no account, while the others use the account’s voice.
propose_changePropose a change for the owner to approveaccount required
- MCP connection
- Yes, to the Kaneme server.
- Account or service
- Kaneme account and voice.
- Authorization requested
- OAuth or API key, scope voice:write: Create a voice, add texts, create or edit documents. Uses credits.
- Data sent
- The fields declared by the MCP contract are sent: idempotencyKey, kind, targetId, expectedRevision, values, profileId. Text is sent only when this tool needs it.
- If the connection is missing
- No call is sent. Connect or reconnect your Kaneme account before running the tool again.
get_changeTrack a verified decisionaccount required
- MCP connection
- Yes, to the Kaneme server.
- Account or service
- Kaneme account and voice.
- Authorization requested
- OAuth or API key, scope voice:read: Your voices, their texts, beliefs, documents, and balance. Nothing is changed and no credits are used.
- Data sent
- The fields declared by the MCP contract are sent: changeId. Text is sent only when this tool needs it.
- If the connection is missing
- No call is sent. Connect or reconnect your Kaneme account before running the tool again.
read_historyRead kept versions and decisionsaccount required
- MCP connection
- Yes, to the Kaneme server.
- Account or service
- Kaneme account and voice.
- Authorization requested
- OAuth or API key, scope voice:read: Your voices, their texts, beliefs, documents, and balance. Nothing is changed and no credits are used.
- Data sent
- The fields declared by the MCP contract are sent: kind, targetId, limit, offset. Text is sent only when this tool needs it.
- If the connection is missing
- No call is sent. Connect or reconnect your Kaneme account before running the tool again.
export_artifactExport a dated private copyaccount required
- MCP connection
- Yes, to the Kaneme server.
- Account or service
- Kaneme account and voice.
- Authorization requested
- OAuth or API key, scope voice:read: Your voices, their texts, beliefs, documents, and balance. Nothing is changed and no credits are used.
- Data sent
- The fields declared by the MCP contract are sent: kind, targetId, format. Text is sent only when this tool needs it.
- If the connection is missing
- No call is sent. Connect or reconnect your Kaneme account before running the tool again.
prepare_voice_contextPrepare my voice for this assistantaccount required
- MCP connection
- Yes, to the Kaneme server.
- Account or service
- Kaneme account and voice.
- Authorization requested
- OAuth or API key, scope voice:read: Your voices, their texts, beliefs, documents, and balance. Nothing is changed and no credits are used.
- Data sent
- The fields declared by the MCP contract are sent: profileId, textLanguage, format, projectId, intent, maxTokens. Text is sent only when this tool needs it.
- If the connection is missing
- No call is sent. Connect or reconnect your Kaneme account before running the tool again.
get_measurementRead a private measurementaccount required
- MCP connection
- Yes, to the Kaneme server.
- Account or service
- Kaneme account and voice.
- Authorization requested
- OAuth or API key, scope voice:read: Your voices, their texts, beliefs, documents, and balance. Nothing is changed and no credits are used.
- Data sent
- The fields declared by the MCP contract are sent: measurementId. Text is sent only when this tool needs it.
- If the connection is missing
- No call is sent. Connect or reconnect your Kaneme account before running the tool again.
get_accountAccount and creditsaccount required
- MCP connection
- Yes, to the Kaneme server.
- Account or service
- Kaneme account and voice.
- Authorization requested
- OAuth or API key, scope voice:read: Your voices, their texts, beliefs, documents, and balance. Nothing is changed and no credits are used.
- Data sent
- The fields declared by the MCP contract are sent: no additional fields. Text is sent only when this tool needs it.
- If the connection is missing
- No call is sent. Connect or reconnect your Kaneme account before running the tool again.
estimate_costEstimate a costaccount required
- MCP connection
- Yes, to the Kaneme server.
- Account or service
- Kaneme account and voice.
- Authorization requested
- OAuth or API key, scope voice:read: Your voices, their texts, beliefs, documents, and balance. Nothing is changed and no credits are used.
- Data sent
- The fields declared by the MCP contract are sent: operation, type. Text is sent only when this tool needs it.
- If the connection is missing
- No call is sent. Connect or reconnect your Kaneme account before running the tool again.
estimate_portable_verificationConfirm the portable measurement costaccount required
- MCP connection
- Yes, to the Kaneme server.
- Account or service
- Kaneme account and voice.
- Authorization requested
- OAuth or API key, scope voice:read: Your voices, their texts, beliefs, documents, and balance. Nothing is changed and no credits are used.
- Data sent
- The fields declared by the MCP contract are sent: executionId. Text is sent only when this tool needs it.
- If the connection is missing
- No call is sent. Connect or reconnect your Kaneme account before running the tool again.
list_voicesList voicesaccount required
- MCP connection
- Yes, to the Kaneme server.
- Account or service
- Kaneme account and voice.
- Authorization requested
- OAuth or API key, scope voice:read: Your voices, their texts, beliefs, documents, and balance. Nothing is changed and no credits are used.
- Data sent
- The fields declared by the MCP contract are sent: no additional fields. Text is sent only when this tool needs it.
- If the connection is missing
- No call is sent. Connect or reconnect your Kaneme account before running the tool again.
get_voiceVoice cardaccount required
- MCP connection
- Yes, to the Kaneme server.
- Account or service
- Kaneme account and voice.
- Authorization requested
- OAuth or API key, scope voice:read: Your voices, their texts, beliefs, documents, and balance. Nothing is changed and no credits are used.
- Data sent
- The fields declared by the MCP contract are sent: profileId. Text is sent only when this tool needs it.
- If the connection is missing
- No call is sent. Connect or reconnect your Kaneme account before running the tool again.
list_voice_referencesList human referencesaccount required
- MCP connection
- Yes, to the Kaneme server.
- Account or service
- Kaneme account and voice.
- Authorization requested
- OAuth or API key, scope voice:read: Your voices, their texts, beliefs, documents, and balance. Nothing is changed and no credits are used.
- Data sent
- The fields declared by the MCP contract are sent: profileId, includeRemoved. Text is sent only when this tool needs it.
- If the connection is missing
- No call is sent. Connect or reconnect your Kaneme account before running the tool again.
add_voice_referenceAdd a human reference textaccount required
- MCP connection
- Yes, to the Kaneme server.
- Account or service
- Kaneme account and voice.
- Authorization requested
- OAuth or API key, scope voice:write: Create a voice, add texts, create or edit documents. Uses credits.
- Data sent
- The fields declared by the MCP contract are sent: profileId, text, title, format, provenance, attestation, idempotencyKey. Text is sent only when this tool needs it.
- If the connection is missing
- No call is sent. Connect or reconnect your Kaneme account before running the tool again.
remove_voice_referenceRemove a referenceaccount required
- MCP connection
- Yes, to the Kaneme server.
- Account or service
- Kaneme account and voice.
- Authorization requested
- OAuth or API key, scope voice:manage: Separate permission: archive, trash, restore, or revoke. Free, and nothing is ever permanently deleted.
- Data sent
- The fields declared by the MCP contract are sent: referenceId. Text is sent only when this tool needs it.
- If the connection is missing
- No call is sent. Connect or reconnect your Kaneme account before running the tool again.
restore_voice_referenceRestore a referenceaccount required
- MCP connection
- Yes, to the Kaneme server.
- Account or service
- Kaneme account and voice.
- Authorization requested
- OAuth or API key, scope voice:manage: Separate permission: archive, trash, restore, or revoke. Free, and nothing is ever permanently deleted.
- Data sent
- The fields declared by the MCP contract are sent: referenceId. Text is sent only when this tool needs it.
- If the connection is missing
- No call is sent. Connect or reconnect your Kaneme account before running the tool again.
list_voice_revision_proposalsList voice revision proposalsaccount required
- MCP connection
- Yes, to the Kaneme server.
- Account or service
- Kaneme account and voice.
- Authorization requested
- OAuth or API key, scope voice:write: Create a voice, add texts, create or edit documents. Uses credits.
- Data sent
- The fields declared by the MCP contract are sent: profileId, includeDecided. Text is sent only when this tool needs it.
- If the connection is missing
- No call is sent. Connect or reconnect your Kaneme account before running the tool again.
propose_voice_revisionPropose a voice revisionaccount required
- MCP connection
- Yes, to the Kaneme server.
- Account or service
- Kaneme account and voice.
- Authorization requested
- OAuth or API key, scope voice:write: Create a voice, add texts, create or edit documents. Uses credits.
- Data sent
- The fields declared by the MCP contract are sent: profileId, field, proposedValue, observation, evidence, proposed, kept, sessionKey, idempotencyKey. Text is sent only when this tool needs it.
- If the connection is missing
- No call is sent. Connect or reconnect your Kaneme account before running the tool again.
decide_voice_revisionDecide a voice revisionaccount required
- MCP connection
- Yes, to the Kaneme server.
- Account or service
- Kaneme account and voice.
- Authorization requested
- OAuth or API key, scope voice:write: Create a voice, add texts, create or edit documents. Uses credits.
- Data sent
- The fields declared by the MCP contract are sent: proposalId, action, ownerApproved, snoozeDays. Text is sent only when this tool needs it.
- If the connection is missing
- No call is sent. Connect or reconnect your Kaneme account before running the tool again.
set_voice_languageSet the voice languageaccount required
- MCP connection
- Yes, to the Kaneme server.
- Account or service
- Kaneme account and voice.
- Authorization requested
- OAuth or API key, scope voice:write: Create a voice, add texts, create or edit documents. Uses credits.
- Data sent
- The fields declared by the MCP contract are sent: profileId, language, ownerApproved. Text is sent only when this tool needs it.
- If the connection is missing
- No call is sent. Connect or reconnect your Kaneme account before running the tool again.
create_voiceCreate a voiceaccount required
- MCP connection
- Yes, to the Kaneme server.
- Account or service
- Kaneme account and voice.
- Authorization requested
- OAuth or API key, scope voice:write: Create a voice, add texts, create or edit documents. Uses credits.
- Data sent
- The fields declared by the MCP contract are sent: text, name, provenance, language, idempotencyKey. Text is sent only when this tool needs it.
- If the connection is missing
- No call is sent. Connect or reconnect your Kaneme account before running the tool again.
interview_voiceInterview the author about their voiceaccount required
- MCP connection
- Yes, to the Kaneme server.
- Account or service
- Kaneme account and voice.
- Authorization requested
- OAuth or API key, scope voice:write: Create a voice, add texts, create or edit documents. Uses credits.
- Data sent
- The fields declared by the MCP contract are sent: profileId, answers, applyPreviewId, ownerApproved. Text is sent only when this tool needs it.
- If the connection is missing
- No call is sent. Connect or reconnect your Kaneme account before running the tool again.
list_voice_assetsRead a voice’s Vaultaccount required
- MCP connection
- Yes, to the Kaneme server.
- Account or service
- Kaneme account and voice.
- Authorization requested
- OAuth or API key, scope voice:read: Your voices, their texts, beliefs, documents, and balance. Nothing is changed and no credits are used.
- Data sent
- The fields declared by the MCP contract are sent: profileId, kind, limit, cursor. Text is sent only when this tool needs it.
- If the connection is missing
- No call is sent. Connect or reconnect your Kaneme account before running the tool again.
add_voice_assetAdd a proof to the Vaultaccount required
- MCP connection
- Yes, to the Kaneme server.
- Account or service
- Kaneme account and voice.
- Authorization requested
- OAuth or API key, scope voice:write: Create a voice, add texts, create or edit documents. Uses credits.
- Data sent
- The fields declared by the MCP contract are sent: text, kind, title, profileId, provenance, idempotencyKey. Text is sent only when this tool needs it.
- If the connection is missing
- No call is sent. Connect or reconnect your Kaneme account before running the tool again.
list_beliefsRead beliefsaccount required
- MCP connection
- Yes, to the Kaneme server.
- Account or service
- Kaneme account and voice.
- Authorization requested
- OAuth or API key, scope voice:read: Your voices, their texts, beliefs, documents, and balance. Nothing is changed and no credits are used.
- Data sent
- The fields declared by the MCP contract are sent: profileId, status, limit, cursor. Text is sent only when this tool needs it.
- If the connection is missing
- No call is sent. Connect or reconnect your Kaneme account before running the tool again.
list_subvoicesRead channel sub-voicesaccount required
- MCP connection
- Yes, to the Kaneme server.
- Account or service
- Kaneme account and voice.
- Authorization requested
- OAuth or API key, scope voice:read: Your voices, their texts, beliefs, documents, and balance. Nothing is changed and no credits are used.
- Data sent
- The fields declared by the MCP contract are sent: profileId. Text is sent only when this tool needs it.
- If the connection is missing
- No call is sent. Connect or reconnect your Kaneme account before running the tool again.
record_signalRecord feedback on the voiceaccount required
- MCP connection
- Yes, to the Kaneme server.
- Account or service
- Kaneme account and voice.
- Authorization requested
- OAuth or API key, scope voice:write: Create a voice, add texts, create or edit documents. Uses credits.
- Data sent
- The fields declared by the MCP contract are sent: kind, reason, profileId, format, projectId, documentId, sourceTitle, proposed, kept. Text is sent only when this tool needs it.
- If the connection is missing
- No call is sent. Connect or reconnect your Kaneme account before running the tool again.
score_textInspect writing styleaccount required
- MCP connection
- Yes, to the Kaneme server.
- Account or service
- Kaneme account and voice.
- Authorization requested
- OAuth or API key, scope voice:measure: Free review, stamp, and comparison of two writings. The stamp and the comparison use credits.
- Data sent
- The text and the options listed by the contract (text, profileId) are sent to the authenticated MCP server.
- If the connection is missing
- No call is sent. No account yet? Create your voice: the passport starts with 100 words, no card.
read_observatory_signalsObservatory reading (free)no account
- MCP connection
- Yes, to the Kaneme server.
- Account or service
- Kaneme public MCP server; no account.
- Authorization requested
- No account authorization.
- Data sent
- The text, its language and its type are sent for this request, read by the frozen Observatoire method, then discarded. No account, no credits.
- If the connection is missing
- Without an account, use the public MCP address. The client still has to connect to this server to call the tool.
verify_authorshipVerify authorship (probability)account required
- MCP connection
- Yes, to the Kaneme server.
- Account or service
- Kaneme account and voice.
- Authorization requested
- OAuth or API key, scope voice:measure: Free review, stamp, and comparison of two writings. The stamp and the comparison use credits.
- Data sent
- The fields declared by the MCP contract are sent: text, question, profileId, expectedReferenceId, reportedContextId, portableExecutionId, format. Text is sent only when this tool needs it.
- If the connection is missing
- No call is sent. Connect or reconnect your Kaneme account before running the tool again.
compare_textsCompare a text to a referenceaccount required
- MCP connection
- Yes, to the Kaneme server.
- Account or service
- Kaneme account and voice.
- Authorization requested
- OAuth or API key, scope voice:measure: Free review, stamp, and comparison of two writings. The stamp and the comparison use credits.
- Data sent
- The fields declared by the MCP contract are sent: text, reference, referenceProfileId, question. Text is sent only when this tool needs it.
- If the connection is missing
- No call is sent. Connect or reconnect your Kaneme account before running the tool again.
generate_in_voiceWrite in the voiceaccount required
- MCP connection
- Yes, to the Kaneme server.
- Account or service
- Kaneme account and voice.
- Authorization requested
- OAuth or API key, scope voice:generate: Write or realign a text on your behalf, in your voice. Uses credits.
- Data sent
- The fields declared by the MCP contract are sent: prompt, type, instruction, format, profileId, projectId, inspect, save, title, idempotencyKey. Text is sent only when this tool needs it.
- If the connection is missing
- No call is sent. Connect or reconnect your Kaneme account before running the tool again.
improve_in_voiceImprove a text in the voiceaccount required
- MCP connection
- Yes, to the Kaneme server.
- Account or service
- Kaneme account and voice.
- Authorization requested
- OAuth or API key, scope voice:generate: Write or realign a text on your behalf, in your voice. Uses credits.
- Data sent
- The fields declared by the MCP contract are sent: text, profileId, protectedPassages, idempotencyKey. Text is sent only when this tool needs it.
- If the connection is missing
- No call is sent. Connect or reconnect your Kaneme account before running the tool again.
create_projectCreate a projectaccount required
- MCP connection
- Yes, to the Kaneme server.
- Account or service
- Kaneme account and voice.
- Authorization requested
- OAuth or API key, scope voice:write: Create a voice, add texts, create or edit documents. Uses credits.
- Data sent
- The fields declared by the MCP contract are sent: name, instructions, context, profileId, idempotencyKey. Text is sent only when this tool needs it.
- If the connection is missing
- No call is sent. Connect or reconnect your Kaneme account before running the tool again.
list_projectsList projectsaccount required
- MCP connection
- Yes, to the Kaneme server.
- Account or service
- Kaneme account and voice.
- Authorization requested
- OAuth or API key, scope voice:read: Your voices, their texts, beliefs, documents, and balance. Nothing is changed and no credits are used.
- Data sent
- The fields declared by the MCP contract are sent: limit, cursor. Text is sent only when this tool needs it.
- If the connection is missing
- No call is sent. Connect or reconnect your Kaneme account before running the tool again.
add_project_contextAdd to project contextaccount required
- MCP connection
- Yes, to the Kaneme server.
- Account or service
- Kaneme account and voice.
- Authorization requested
- OAuth or API key, scope voice:write: Create a voice, add texts, create or edit documents. Uses credits.
- Data sent
- The fields declared by the MCP contract are sent: projectId, text, title, idempotencyKey. Text is sent only when this tool needs it.
- If the connection is missing
- No call is sent. Connect or reconnect your Kaneme account before running the tool again.
list_documentsList documentsaccount required
- MCP connection
- Yes, to the Kaneme server.
- Account or service
- Kaneme account and voice.
- Authorization requested
- OAuth or API key, scope voice:read: Your voices, their texts, beliefs, documents, and balance. Nothing is changed and no credits are used.
- Data sent
- The fields declared by the MCP contract are sent: query, projectId, format, limit, cursor. Text is sent only when this tool needs it.
- If the connection is missing
- No call is sent. Connect or reconnect your Kaneme account before running the tool again.
get_documentRead a documentaccount required
- MCP connection
- Yes, to the Kaneme server.
- Account or service
- Kaneme account and voice.
- Authorization requested
- OAuth or API key, scope voice:read: Your voices, their texts, beliefs, documents, and balance. Nothing is changed and no credits are used.
- Data sent
- The fields declared by the MCP contract are sent: documentId. Text is sent only when this tool needs it.
- If the connection is missing
- No call is sent. Connect or reconnect your Kaneme account before running the tool again.
create_documentCreate a documentaccount required
- MCP connection
- Yes, to the Kaneme server.
- Account or service
- Kaneme account and voice.
- Authorization requested
- OAuth or API key, scope voice:write: Create a voice, add texts, create or edit documents. Uses credits.
- Data sent
- The fields declared by the MCP contract are sent: title, markdown, projectId, profileId, format, provenance, idempotencyKey. Text is sent only when this tool needs it.
- If the connection is missing
- No call is sent. Connect or reconnect your Kaneme account before running the tool again.
update_documentEdit a documentaccount required
- MCP connection
- Yes, to the Kaneme server.
- Account or service
- Kaneme account and voice.
- Authorization requested
- OAuth or API key, scope voice:write: Create a voice, add texts, create or edit documents. Uses credits.
- Data sent
- The fields declared by the MCP contract are sent: documentId, title, markdown, replace, projectId, profileId, format, provenance. Text is sent only when this tool needs it.
- If the connection is missing
- No call is sent. Connect or reconnect your Kaneme account before running the tool again.
delete_documentMove a document to trashaccount required
- MCP connection
- Yes, to the Kaneme server.
- Account or service
- Kaneme account and voice.
- Authorization requested
- OAuth or API key, scope voice:manage: Separate permission: archive, trash, restore, or revoke. Free, and nothing is ever permanently deleted.
- Data sent
- The fields declared by the MCP contract are sent: documentId. Text is sent only when this tool needs it.
- If the connection is missing
- No call is sent. Connect or reconnect your Kaneme account before running the tool again.
list_project_contextsList a project’s contextaccount required
- MCP connection
- Yes, to the Kaneme server.
- Account or service
- Kaneme account and voice.
- Authorization requested
- OAuth or API key, scope voice:read: Your voices, their texts, beliefs, documents, and balance. Nothing is changed and no credits are used.
- Data sent
- The fields declared by the MCP contract are sent: projectId, includeArchived, includeTrashed. Text is sent only when this tool needs it.
- If the connection is missing
- No call is sent. Connect or reconnect your Kaneme account before running the tool again.
list_trashRead the trashaccount required
- MCP connection
- Yes, to the Kaneme server.
- Account or service
- Kaneme account and voice.
- Authorization requested
- OAuth or API key, scope voice:manage: Separate permission: archive, trash, restore, or revoke. Free, and nothing is ever permanently deleted.
- Data sent
- The fields declared by the MCP contract are sent: no additional fields. Text is sent only when this tool needs it.
- If the connection is missing
- No call is sent. Connect or reconnect your Kaneme account before running the tool again.
manage_lifecycleArchive, restore or revokeaccount required
- MCP connection
- Yes, to the Kaneme server.
- Account or service
- Kaneme account and voice.
- Authorization requested
- OAuth or API key, scope voice:manage: Separate permission: archive, trash, restore, or revoke. Free, and nothing is ever permanently deleted.
- Data sent
- The fields declared by the MCP contract are sent: dryRun, items, idempotencyKey. Text is sent only when this tool needs it.
- If the connection is missing
- No call is sent. Connect or reconnect your Kaneme account before running the tool again.
measure_authorshipTrial measurement, no accountno account
- MCP connection
- Yes, to the Kaneme server.
- Account or service
- Kaneme public MCP server; no account.
- Authorization requested
- No account authorization.
- Data sent
- Three reference texts and the text to measure are sent for this request. Nothing is kept after the anonymous call.
- If the connection is missing
- Without an account, use the public MCP address. The client still has to connect to this server to call the tool.
This describes the contract; it does not guess your client’s current state. After expiry, the client exposes its own reconnect action. The public address is https://kaneme.com/api/mcp/public.
Follow the setup guide for your client
Claude
Claude
Settings → Connectors → Add custom connector. Name it Kaneme, paste the address, then authorize access.
Claude documentationChatGPT
ChatGPT
Settings → Apps and connectors → Create. Name it Kaneme, paste the address, choose OAuth, then authorize access.
ChatGPT documentationGrok
Grok web
grok.com/connectors → New Connector → Custom. Name it Kaneme, paste the address, then authorize access.
Grok documentationCursor
Cursor desktop
Settings → MCP → Add server. Paste the configuration below, then authenticate Kaneme.
~/.cursor/mcp.json
Notion
Notion Custom Agents
Custom Agent → Tools & Access → Add connection → Custom MCP server. Name it Kaneme, paste the address, then choose OAuth.
Notion documentationGemini CLI
Gemini CLI
Add a remote MCP server named Kaneme with this address. Use OAuth when your client offers it.
HTTP configuration with an API key
Copilot Studio
Copilot Studio
Add a remote MCP server named Kaneme with this address. Use OAuth when your client offers it.
HTTP configuration with an API key
Perplexity
Perplexity
Add a remote MCP server named Kaneme with this address. Use OAuth when your client offers it.
HTTP configuration with an API key
Claude Code
Claude Code
Add a remote MCP server named Kaneme with this address. Use OAuth when your client offers it.
HTTP configuration with an API key
Codex
Codex
With an already connected Kaneme plugin, ask for your voices. For manual Codex configuration, add this block to config.toml, then run codex mcp login kaneme. A successful call confirms the connection, not authorization alone.
config.toml
n8n
n8n MCP Client · n8n MCP Client Tool
Add an MCP Client node to your workflow, or MCP Client Tool for an AI agent. Select HTTP Streamable and paste https://kaneme.com/api/mcp. Authenticate with MCP OAuth2 or Bearer Auth and your Kaneme API key. MCP Client Tool version 1.2 and later offer these options; version 1 only offers SSE Endpoint. To call the REST API, use HTTP Request with Header Auth: Authorization: Bearer [your Kaneme key], then an /api/v1/ endpoint from the Kaneme documentation.
n8n documentationThe core catalog, then more if you need it
A connection receives the 32 core tools below: the voice journey, from creation to measurement, and the documents it produces. Add ?catalog=full (https://kaneme.com/api/mcp?catalog=full) for all 43 tools: projects and their context, reading and removing documents, trash and lifecycle, history and export. Every tool costs tokens on each connection, so add them only if your assistant uses them.
propose_change- Propose change
get_change- Get change
prepare_voice_context- Prepare voice context
get_measurement- Get measurement
get_account- Get account
estimate_cost- Estimate cost
estimate_portable_verification- Estimate portable verification
list_voices- List voices
get_voice- Get voice
list_voice_references- List voice references
add_voice_reference- Add voice reference
remove_voice_reference- Remove voice reference
restore_voice_reference- Restore voice reference
list_voice_revision_proposals- List voice revision proposals
propose_voice_revision- Propose voice revision
decide_voice_revision- Decide voice revision
set_voice_language- Set voice language
create_voice- Create voice
interview_voice- Interview voice
list_voice_assets- List voice assets
add_voice_asset- Add voice asset
list_beliefs- List beliefs
list_subvoices- List subvoices
record_signal- Record signal
score_text- Score text
read_observatory_signals- Read observatory signals
verify_authorship- Verify authorship
compare_texts- Compare texts
generate_in_voice- Generate in voice
improve_in_voice- Improve in voice
create_document- Create document
update_document- Update document
Keep the voice. Change the tool.
MCP and REST use the same profileId. Kaneme records which channel made the call, but the submitted text stays out of telemetry.
Portable flow
Offline certificate verification
Contract 2.12: textDigest is SHA-256 over kaneme-text-v1. remove U+200B, U+2060 and U+FEFF (preserve U+200D); NFC; replace every ECMAScript whitespace run (/\s+/gu, including NBSP) with U+0020; trim; UTF-8 without BOM; SHA-256 in lowercase hexadecimal. This step can run locally without sending the text.
Test vector (straight apostrophe, no line break):
Bonjour à tous ! Rock & roll, l'été.
SHA-256: cd58fb5dcf1722b9f2520eddeebedca163883466388f2dbdf5e3b7fb61f08b99Fetch /.well-known/kaneme-certificate-key from the trusted issuer. Select keys by trust.signature.keyId, including retired keys. Recursively sort signedCore object keys, preserve array order, serialize compact JSON (sorted-keys-json) exactly as ECMAScript JSON.stringify does — non-ASCII characters stay unescaped (Python: json.dumps(core, sort_keys=True, separators=(",", ":"), ensure_ascii=False)) —, encode UTF-8, decode the base64url signature and verify Ed25519 using publicKeyPem. Localized claims labels and the response envelope are outside the signature. Existing unsigned certificates stay trust.model=origin; legacy text digests are null. Voice certificates attest no text.
A stored signature attests that Kaneme measured this text on this date, with this result. It does not establish who wrote it. A certificate is an indication, never proof. Trust in the downloaded public key and current revocation status still requires the issuer.
For signed certificates, compare the text with signedCore.textDigest only after verifying the signature, issuer and expected token. Check that the envelope textDigest matches it; an unsigned envelope field is not authenticated by the signature.