# Your first connection.

Discover and inspect publicly. Authenticate before executing.

Updated: 2026-09-21.
## Connect over MCP

Public discovery endpoint: [https://ai.agentik.cc/mcp/public](https://ai.agentik.cc/mcp/public). It exposes `discover_tools` and `inspect_tool`.

Authenticated endpoint: [https://ai.agentik.cc/mcp](https://ai.agentik.cc/mcp). Use the client’s supported OAuth flow or an Agentik API key. Authorised clients can also call `run_tool` and `get_run`. Use `get_account` for the actual workspace balance and payment status. `prepare_topup` prepares a human review link for a requested credit amount; it does not charge a card. Wait for settled credit before resuming an authorised paid task. Follow the [client setup guides](/docs/clients).

## Try discovery over REST

This request only searches the catalog; it does not call a provider.


```sh
curl -sS 'https://api.agentik.cc/v1/discover' \
  -H 'Content-Type: application/json' \
  --data '{"query":"search the web","limit":3}'
```


Choose an exact `tool_id` from the result. Read its schema, availability and pricing with `GET /v1/tools/{provider}/{tool}`. Do not invent an ID or inputs.

## Before execution

Start through [sign up](/sign-up). The guided setup prepares your workspace automatically and preserves your chosen app. Authorise its connection with your account; developers can also create a key in workspace settings. You can skip setup and resume its steps from the dashboard. Keep credentials out of prompts, source code, screenshots and URLs. Review the tool’s price and side effects with the person who requested the task.

For REST, `POST https://api.agentik.cc/v1/run` takes `{"tool_id":"<selected tool>","input":{...}}`. Send `Authorization: Bearer <your key>` and a fresh `Idempotency-Key` for this intended execution. The placeholders are not runnable input.

Read the returned state. Reuse the same idempotency key for a transport retry; poll the existing run when it is pending. See [idempotency](/docs/idempotency) and [asynchronous executions](/docs/async).

---

[HTML page](/docs/quickstart) · [Agent index](/llms.txt)