The AI dashboard is currently in beta and may be unavailable or have limited functionality in certain regions.

Tutorial

Connect Token Saver to your AI host

Choose your harness for exact setup, OAuth, verification, and host instructions, then run the complete tier-first lifecycle.

Tip:Production lifecycle tools require OAuth. The consent screen links the host to your Elis account and the Personal or organization billing scope you choose.
Tip:The API can cold-start after a quiet period. If the first connection times out, open https://tryelisai.com/mcp, wait for it to report ready, and retry.
1

Choose your harness

Each tab is a complete setup path and has a shareable ?harness=... URL. Do not substitute one harness's endpoint or configuration keys for another.

Codex AppChatGPTClaude connectorClaude DesktopClaude CodeGitHub CopilotGemini CLIAntigravity

ChatGPT setup

ChatGPT custom MCP apps are currently a web feature. Full MCP is available to Business and Enterprise/Edu workspaces; plan and workspace policy can limit which actions appear.

1. Open the configuration

Enable developer mode, then open Workspace settings → Apps → Create (admin/owner) or Settings → Apps → Create (authorized user).

2. Add Elis Token Saver

Name: Elis Token Saver
MCP server URL: https://api.tryelisai.com/api/mcp/openai
Authentication: OAuth
ChatGPT Create app screen configured with the Elis Token Saver endpoint and OAuth.
Create the app with the OpenAI endpoint, choose OAuth, then scan its tools.

3. Authorize

  1. Your workspace admin must first allow developer mode. Enterprise/Edu workspaces can grant it by role; Business admins and owners manage it for the workspace.
  2. Enter the endpoint, select OAuth, then choose Scan Tools. Complete the Elis sign-in and consent flow when ChatGPT prompts.
  3. After the scan succeeds, choose Create. Publish it only if the whole workspace should use it; a draft is enough for private testing.

4. Verify the connection

  1. Open a new chat and select the draft Elis Token Saver app from the tools menu for the message.
  2. Ask it to call setup_elis_host_instructions or start_elis_token_saver_plan and confirm the lifecycle tools are visible.
  3. If Elis adds or changes tools later, refresh the app actions in workspace settings before testing them.

5. Install the host behavior

ChatGPT does not load repository instruction files the same way coding harnesses do. Put the required lifecycle in the workspace agent or conversation instructions, and keep the Elis app selected whenever a message must call it.

Endpoint: https://api.tryelisai.com/api/mcp/openai

References: OpenAI: developer mode and MCP apps · Complete Elis setup reference

2

Run the complete Elis lifecycle

Connecting the server only exposes tools. The host must still use the same cursor for the whole plan and execute only the tasks Elis discloses. Every ready task includes an authoritative recommended_model_size of nano, small, or frontier. A named model is optional host guidance, not a hardcoded binding.

1. start_elis_token_saver_plan({ goal, constraints?, chain_hint? })
2. submit_elis_task_plan({ plan_id, tasks })       // only when start requests it
3. get_next_elis_task({ plan_id, graph_revision })
4. Execute every ready task using its public execution_handoff and size tier
5. get_next_elis_task({
     plan_id,
     graph_revision,
     previous_result: { task_id, status, output },
     usage: { input_tokens, output_tokens, model, model_tier }
   })
6. Repeat steps 4-5; switch immediately if the server returns a new graph_revision
7. finish_elis_plan({ plan_id, final_answer, total_tokens_used, usage, feedback })
Tip:The main session owns one stable plan cursor. A delegated executor receives the fullexecution_handoff, completes that one task, reports actual model and token usage, and returns control. It does not start a second plan.
3

Authorize a host without built-in OAuth

A raw JSON-RPC client must implement OAuth itself. First read public discovery metadata, register a public client, create an S256 PKCE challenge and state, open consent, validate the returned state, exchange the one-time code, and send the access token in the header.

Show the programmatic OAuth checklist
  1. Read https://api.tryelisai.com/.well-known/oauth-authorization-server.
  2. POST {"client_name":"my-host","redirect_uris":["http://localhost:8765/callback"]} to https://api.tryelisai.com/oauth/register and retain the returned public client_id.
  3. Generate a random code_verifier, its base64url SHA-256 code_challenge without padding, and a random state.
  4. Open /oauth/authorize with response_type=code, the exact redirect URI, code_challenge_method=S256, scope profile token_saver, the state, and the selected harness endpoint as resource.
  5. Verify state, then POST the code, client id, verifier, exact redirect URI, resource, and grant_type=authorization_code to /oauth/token.
  6. Call the selected MCP endpoint with Authorization: Bearer <access_token>. Keep tokens out of URLs and logs.

The copy-paste requests and refresh-token notes are in the full setup reference.

4

Use recall and privacy controls deliberately

A successful authenticated finish can store a proven chain privately in the selected Personal or organization scope. Future similar goals can recall that task sequence. Report honest ok, failed, or blocked task status and actual usage so prediction and savings audits compare against real execution.

// Do not store or recall this plan
start_elis_token_saver_plan({ goal, constraints: { no_store: true } })

// Keep private recall, but exclude this plan from community sharing
start_elis_token_saver_plan({ goal, constraints: { no_community: true } })

// Recall a known private proven chain for a similar goal
start_elis_token_saver_plan({ goal, chain_hint: "elis_chain:<sig>:<plan_id>" })
5

Troubleshoot the common failures

  • No tools: confirm the exact harness endpoint, Streamable HTTP config, host trust/enablement, and workspace MCP policy. Then refresh tools or restart the host.
  • oauth_required or invalid_token: the server is reachable, but the lifecycle is not authorized. Complete authentication again; do not continue anonymously.
  • insufficient_scope: authorize again with token_saver in scope.
  • payment_method_required: open https://app.tryelisai.com/billing, attach a payment method to the selected scope, then retry the lifecycle call.
  • First request times out: wake the API at https://tryelisai.com/mcp and retry after it reports ready.
  • /elis missing: apply every file returned by setup_elis_host_instructions and start a new host session. Gemini CLI can reload commands with /commands reload.
  • Plan revision changed: stop work tied to the old graph_revision and follow the new ready-task wave.

For tool schemas, usage fields, tier semantics, grounding, and finish behavior, continue to MCP Tools & Tier-First Lifecycle.