Product guide

How to use pokt.ai step by step

pokt.ai is a platform for creating, connecting, and managing endpoints, reviewing usage, checking billing, inviting people, and generating MCP tokens to use the account with an AI tool. One token powers two MCP servers: the core pokt.ai server and the helper server at mcp.pokt.ai. The same bundle also includes your organization id so the helper MCP can read your account context. This guide explains what to click, what to look at, and what to do on each screen without assuming prior experience.

Dashboard MCP Account

What the platform does

The platform brings together everything you need to run your account: authentication, organizations, endpoints, usage, billing, members, wallet, and MCP access.

The main navigation lives in the sidebar. From there you open each view and the page content changes based on what you want to do. The MCP token you generate is tied to your user and organization, and the generated bundle is ready for both MCP servers at once.

Getting started

  1. Open the site and create your account.
  2. Check your email and enter the verification code.
  3. Open Dashboard to see your workspace.
  4. Create an endpoint and use its gateway URL.
  5. Go to MCP and generate a token if you want to connect an AI tool.

If you are asked for an email verification code, enter it on the verification screen. Do not close the tab until you finish.

What each sidebar view does

Dashboard
Shows your main account summary: status, usage overview, and quick actions.
Endpoints
Create and manage endpoints. This is where you copy the URL used by your app or AI.
Billing
See how much is being used, what it costs, and whether payments or invoices are pending.
Usage
View real traffic by day, by endpoint, and by network to understand consumption.
Members
Invite people to the organization, change roles, and manage access.
Wallet
Show the connected account, the balance, and wallet-related transactions.
Account
Update your personal information and the organization linked to your account.
MCP
Generate MCP tokens, copy the ready-to-use bundle, and use the same token in both MCP servers.
Docs
Explains how the app works and how to use the platform with no prior experience.

How to use MCP with an AI tool

1. Open /mcp and click Generate token.

2. The app creates a random name and generates a new token.

3. Click Copy MCP and paste the block into your AI tool.

4. The block includes both MCP server URLs, the token, and the user and organization headers.

5. From there, the AI can read organizations, endpoints, usage, networks, and the extra RPC helpers according to the token permissions.

MCP tools

whoami
Returns your identity, active organization, and token permissions from the core MCP.
list_organizations
Lists the organizations your token can access through the core MCP.
list_endpoints
Lists the endpoints in the selected workspace through the core MCP.
create_endpoint
Creates a new endpoint in the active organization through the core MCP.
rotate_endpoint_token
Generates a new token for an endpoint through the core MCP.
get_dashboard_stats
Returns the main dashboard metrics from the core MCP.
get_usage_analytics
Returns usage for a date or date range from the core MCP.
list_networks
Returns the networks supported by the platform through the core MCP.

Helper MCP tools

pk_block_number
Reads the latest block number from the selected endpoint.
pk_balance
Reads and decodes a native balance for any address.
pk_get_tx
Fetches a transaction plus receipt in one response.
pk_get_logs
Queries event logs with address and topic filters.
pk_eth_call
Runs a read-only contract call from a function signature.
pk_rpc_decode
Decodes raw RPC return data against ABI return types.
pk_token_info
Reads token name, symbol, decimals, and total supply.
pk_token_balance
Reads and decodes an ERC-20 balance for a holder.
pk_rpc
Passes through any raw JSON-RPC method not covered above.
pk_list_my_endpoints
Lists the caller’s endpoints using the same bearer token and org header.
pk_endpoint_usage
Returns endpoint usage for a specific period from the helper MCP.
pk_dashboard_stats
Returns dashboard billing and usage summary from the helper MCP.

Copy-ready examples

Gateway RPC
curl -X POST "https://pokt.ai/api/gateway?endpoint=YOUR_ENDPOINT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_blockNumber",
    "params": [],
    "id": 1
  }'
MCP token and bundle
{
  "mcpServers": {
    "poktai-tools": {
      "type": "http",
      "url": "https://mcp.pokt.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_TOKEN",
        "X-Pokt-User-Id": "user_123",
        "X-Pokt-User-Email": "you@pokt.ai",
        "X-Pokt-User-Name": "Your Name",
        "X-Pokt-Org-Id": "org_123",
        "X-Pokt-Org-Name": "Main Workspace"
      }
    }
  }
}