SMMAiSetup Developer Portal
Welcome to the SMMAiSetup Developer Portal. Build programmatic WhatsApp automations, integrate SMM provider APIs, query real-time order states, and execute cryptocurrency payments.
Quickstart Guide
1. Instant Self-Serve Agent Key (Zero Friction)
Autonomous AI agents can generate a trial sandbox token with 100 free test credits instantly:
curl -X POST https://smmaisetup.com/api/v1/auth/agent-key \
-H "Content-Type: application/json" \
-d '{"agent_name": "my_agent"}'
Response:
{
"status": "success",
"access_token": "eyJhbGciOi...",
"token_type": "bearer",
"agent_id": "agent_3a9f1b",
"tier": "free_trial",
"credits": 100,
"sandbox_mode": true
}
2. Python SDK Example
import requests
# 1. Obtain trial agent access token
resp = requests.post("https://smmaisetup.com/api/v1/auth/agent-key", json={"agent_name": "python_bot"})
token = resp.json()["access_token"]
# 2. Query available SMM capabilities
headers = {"Authorization": f"Bearer {token}", "Content-Type": "application/json"}
services = requests.get("https://smmaisetup.com/api/v1/services", headers=headers).json()
print("Available Services:", len(services["capabilities"]))
# 3. Simulate order placement in sandbox mode
order = requests.post("https://smmaisetup.com/api/v1/sandbox/order", json={
"service_id": 101,
"link": "https://instagram.com/p/example",
"quantity": 250
}, headers=headers).json()
print("Simulated Order ID:", order["order"])
3. TypeScript / Node.js Example
import axios from "axios";
async function main() {
const { data: auth } = await axios.post("https://smmaisetup.com/api/v1/auth/agent-key", {
agent_name: "node_agent"
});
const client = axios.create({
baseURL: "https://smmaisetup.com/api/v1",
headers: { Authorization: `Bearer ${auth.access_token}` }
});
const { data: health } = await client.get("/health");
console.log("System Status:", health.status, "Version:", health.version);
}
main();
4. Model Context Protocol (MCP) Setup
Connect Claude Desktop, Cursor, or ChatGPT to SMMAiSetup via JSON-RPC 2.0 Streamable HTTP:
{
"mcpServers": {
"smmaisetup": {
"url": "https://smmaisetup.com/api/mcp",
"transport": "http"
}
}
}
Rate Limiting & IETF RFC Headers
All responses return RFC-compliant rate limit headers:
- `RateLimit-Limit`: Maximum requests per window
- `RateLimit-Remaining`: Remaining request quota
- `RateLimit-Reset`: Time in seconds until quota resets
- `RateLimit-Policy`: Quota description (`120;w=60`)
REST Versioning & Deprecation Policy
- **Current Version**: `v1` (Available under `/api/v1/*` or `/api/*` with `API-Version: 2026-01-01`).
- **Deprecation Policy**: Any endpoint scheduled for deprecation will provide at least 6 months advance notice signaled via RFC 8594 `Sunset: <date>` and `Deprecation: <date>` HTTP headers. See [/deprecation-policy](/deprecation-policy).
Protocols & Tool Calling
- **OpenAPI 3.1 Documentation**: [/docs](/docs)
- **OpenAPI Specification**: [/openapi.json](/openapi.json)
- **ReDoc Interactive Documentation**: [/redoc](/redoc)
- **Model Context Protocol (MCP)**: `POST /api/mcp` (Streamable HTTP & JSON-RPC 2.0)
- **MCP Server Card**: [/.well-known/mcp/server-card.json](/.well-known/mcp/server-card.json)
- **A2A Protocol Agent Card**: [/.well-known/agent-card.json](/.well-known/agent-card.json)
- **Agent Skills Discovery**: [/.well-known/agent-skills/index.json](/.well-known/agent-skills/index.json)
- **Agentic Commerce Protocol (ACP)**: [/.well-known/acp.json](/.well-known/acp.json)
- **Universal Commerce Protocol (UCP)**: [/.well-known/ucp.json](/.well-known/ucp.json)
- **x402 Micropayment Protocol**: [/.well-known/x402.json](/.well-known/x402.json)
- **LLM Manifest**: [/llms.txt](/llms.txt) and [/llms-full.txt](/llms-full.txt)
- **CLI Tool**: `curl -sSL https://smmaisetup.com/cli.sh | bash`