Skip to main content

SmarToken MCP

Create a SmarToken account

A stdio MCP server exposing list_models (public model metadata and pricing) and chat_completion (one text request). Model list and pricing can change; consult the live model endpoint and pricing.

The model lookup and one paid DeepSeek V4.1 Flash completion have been verified against the production API through the official Python MCP client. Other models and individual host applications should be verified in their own environments.

chat_completion sends the user's prompt to SmarToken and can incur charges. It uses the user's own SMTOKEN_API_KEY, bounded output, and does not automatically retry. A timeout or server error can leave the outcome unknown: check usage and request logs before retrying. Model output is untrusted content. Review your MCP client's approval settings; tool annotations do not guarantee approval prompts.

Get started

  1. Create an account or sign in. Registration does not include free API credit.
  2. Open Billing and add prepaid credit before making billable calls. Check the payment amount before confirming.
  3. Open API keys and create a key. Copy the full key when shown; existing keys cannot be revealed again. Set an appropriate budget and model scope.
  4. Install uv and configure your MCP client below. Use your own key and keep it private.

Cursor and Claude Desktop configuration

Use the following entry in Cursor's global ~/.cursor/mcp.json or a project's .cursor/mcp.json. For Claude Desktop, use ~/Library/Application Support/Claude/claude_desktop_config.json on macOS or %APPDATA%\\Claude\\claude_desktop_config.json on Windows. Merge the entry into an existing mcpServers object rather than replacing other servers. See Cursor's MCP guide and the MCP SDK Claude guide.

{
  "mcpServers": {
    "smartoken": {
      "command": "/absolute/path/to/uvx",
      "args": ["smartoken-mcp==0.1.3"],
      "env": { "SMTOKEN_API_KEY": "YOUR_SMARTOKEN_KEY" }
    }
  }
}

Replace the executable path with the result of which uvx on macOS/Linux or where uvx on Windows, and replace the placeholder with your SmarToken key. Windows paths in JSON need escaped backslashes. These JSON files contain a secret: restrict file access, do not commit or share them, and prefer your client's secure secret storage if available. Restart the client and confirm that list_models and chat_completion appear. list_models does not require a key or charge; chat_completion sends the prompt and can incur charges. Ask the client to list SmarToken models first; then explicitly request a short completion with an available text model.

The server reports links when a key is missing or invalid. For HTTP 402 it distinguishes insufficient balance from a key budget/model-scope limit when the API identifies the cause; otherwise check both Billing and API keys. Errors from network failures or HTTP 5xx can leave the request outcome unknown: inspect usage before retrying. Do not automatically retry.

This is a local stdio server, not a remote URL. It does not change the host application's underlying model and does not provide balance or account-management tools. It does not support tool calls, images or structured output in model requests. Client approval settings determine whether tool use prompts for confirmation.

The MCP server is a tool interface; installing it does not change your host application’s underlying model. See the API quickstart for direct Python, JavaScript and LiteLLM examples.

Metadata

Release files for smartoken-mcp 0.1.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for smartoken-mcp 0.1.3
File Size Uploaded Provenance Actions
smartoken_mcp-0.1.3.tar.gz 7.3 kB With provenance Details for smartoken_mcp-0.1.3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for smartoken-mcp 0.1.3
File Interpreter ABI Platform Actions
smartoken_mcp-0.1.3-py3-none-any.whl Python 3 none any Details for smartoken_mcp-0.1.3-py3-none-any.whl

Total release size: 13.6 kB

Release files / smartoken_mcp-0.1.3.tar.gz

Download URL smartoken_mcp-0.1.3.tar.gz
Size 7.3 kB
Tags Source
SHA-256 checksum
How to use checksums
63577a16541d4bf42eae3de65c8dec90ff9eba1bfb73d8f50b913d988970cdd7
BLAKE2b-256 checksum
How to use checksums
2e5f8f37c26d192e0f600c3fef7ec258d375b8b2d46856fb8cbe9c25323fd648
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.

Transparency log

Release files / smartoken_mcp-0.1.3-py3-none-any.whl

Download URL smartoken_mcp-0.1.3-py3-none-any.whl
Size 6.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f672cc2f8fb1e889a79757fedd3dbd127e3b4bb52714fe97d9931b152992cb6c
BLAKE2b-256 checksum
How to use checksums
d8f0e72d028dd0f84b934659519e36476e74c1f4b07d732815f4625b56305b65
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.

Transparency log

Security for smartoken-mcp 0.1.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for smartoken_mcp-0.1.3.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page