Skip to content

MCP tools

The EkLine MCP server offers these tools. To connect a client, see Connect an MCP client.

ItemValue
URLhttps://ekline.io/api/mcp
TransportStreamable HTTP
AuthenticationAn Authorization: Bearer <key> header with a personal API key. No OAuth.
Key formatek_<id>_<secret>
Key scopeOne member in one organization. Membership is checked on every call.
Missing, revoked or unknown keyThe server answers with no tools rather than an error.
ToolWhat it doesMain parameters
create_sessionStarts a Docs Agent or Marketing Agent session and returns its id and a link to follow it. Returns once the session starts, not when it finishes.prompt (required): the task. agent: docs (default) or marketing.
get_session_statusReports a session’s status and up to six of its most recent messages.sessionId (required)
send_session_messageSends a correction, extra requirement or reference to a session that is running. Returns once the agent has the message.sessionId and prompt (both required)
list_sessionsLists your organization’s sessions: what each was asked and when it was last active. A pasted pull request, merge request, Jira or session URL finds the sessions related to it. Does not report whether a session is still running.query: text to search for, or a URL. agent: docs, marketing or all (default). limit: 1 to 100 (default 20).
search_ekline_docsAnswers a question about EkLine from the published docs, with up to four sections and the URL of the page each came from.query (required)
get_company_profileReads your organization’s company profile, including its named personas, competitors, brand terms and documentation sites.None
update_company_profileReplaces the profile fields you give, with no review step, and reports what each held before. Cannot clear a field or change named personas, competitors, brand terms or documentation sites.At least one of companyProfile, keyFeatures, audience, competitors, toneAndVoice, visualStyle, additionalContext, each 1 to 10,000 characters
create_rulesCreates a Docs Agent rule, with no review step. Refuses a name your organization already uses. Cannot change, turn off or delete a rule.name (required, up to 200 characters), content (required, up to 20,000 characters), ruleType: general (default) or review, paths: up to 20 file globs

get_session_status returns one of these.

StatusMeaning
workingThe agent is still running the session.
completedThe session finished.
failedThe session ran into a problem, or has had no activity for more than 15 minutes without finishing.
cancelledThe session was stopped.
ruleTypeApplies
generalOn every task the agent works on
reviewBefore the agent opens or updates a documentation pull request
ToolWhat it doesMain parameters
list_journeysLists your organization’s journeys: each one’s id, title, kind, whether it is a draft or published, and how many reports it has.None
get_journeyReads one journey: what it asks, as which persona, its checks, which agents run it and how many times, and a summary of its latest report.journeyId
get_journey_reportReads one report: how each agent did on each check, the report’s findings, and an excerpt of each answer with the sources it cited.journeyId, reportId
get_journey_runReads one run in full: every answer, every source cited, and each check result with its reason.journeyId, reportId, runId
create_journeyCreates a draft journey. It does not run until you call run_journey.sourcePrompt, title, kind (research or task), definition (1 to 20 turns, a persona, up to 50 checks), runConfig (agentIds and runCount)
update_journeyChanges a journey that has not run yet. Each field you give replaces the stored one in full.journeyId, plus at least one of the create_journey fields
run_journeyQueues a run. It sends real requests to the AI agents and writes a report, usually within a few minutes. Returns once the run is queued.journeyId
runConfig fieldValues
agentIdsOne or more of chatgpt, claude, perplexity, gemini, claude-code, codex. A task journey runs only on claude-code and codex.
runCountHow many times each agent runs the journey, 1 to 25
webSearchOptional. On by default.
agentModelsOptional. Each agent uses its default model when left out.

Built on Potluck Docs, our open source template.