SDK Examples

from aipaygen_mcp import AiPayGenClient

client = AiPayGenClient(
    base_url="https://aipaygen.com",
    api_key="your-api-key"  # Or omit for free tier
)

# Sentiment analysis
result = client.sentiment("I love this product!")
print(result)

# Web search
results = client.search("x402 protocol", n=5)
for r in results:
    print(f"  {r['title']}: {r['url']}")

# Code generation
code = client.code("fibonacci function", language="python")
print(code)

from aipaygen_mcp import AiPayGenClient

client = AiPayGenClient(base_url="https://aipaygen.com")

# Chain: research -> summarize -> translate
result = client.chain([
    {"tool": "research", "input": {"query": "AI agent payments"}},
    {"tool": "summarize", "input": {"text": "$prev.result"}},
    {"tool": "translate", "input": {"text": "$prev.result", "target": "French"}}
])

print(f"Completed in {result['total_time_ms']}ms")
print(result["final_result"])

# Install and run
pip install aipaygen-mcp
aipaygen-mcp --api-key YOUR_KEY

# Or connect to remote MCP
# URL: https://mcp.aipaygen.com/mcp

const BASE = "https://aipaygen.com";
// const API_KEY = "your-api-key";  // Optional

const resp = await fetch(`${BASE}/sentiment`, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    // "X-API-Key": API_KEY,  // Uncomment for paid tier
  },
  body: JSON.stringify({
    text: "I love building with AI agents!"
  })
});

const data = await resp.json();
console.log(`Polarity: ${data.polarity}, Score: ${data.score}`);

const resp = await fetch("https://aipaygen.com/chain", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    steps: [
      { tool: "research", input: { query: "x402 payment protocol" } },
      { tool: "summarize", input: { text: "$prev.result", format: "bullets" } },
      { tool: "translate", input: { text: "$prev.result", target: "Japanese" } }
    ]
  })
});

const { chain, final_result, total_time_ms } = await resp.json();
chain.forEach(s => console.log(`Step ${s.step} (${s.tool}): ${s.time_ms}ms`));
console.log(`\nResult (${total_time_ms}ms):\n${final_result}`);

const resp = await fetch("https://aipaygen.com/chat", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    messages: [{ role: "user", content: "Explain quantum computing" }],
    stream: true
  })
});

const reader = resp.body.getReader();
const decoder = new TextDecoder();

while (true) {
  const { done, value } = await reader.read();
  if (done) break;
  const text = decoder.decode(value);
  for (const line of text.split("\n")) {
    if (line.startsWith("data: ")) {
      process.stdout.write(line.slice(6));
    }
  }
}

curl -s https://aipaygen.com/sentiment \
  -H "Content-Type: application/json" \
  -d '{"text": "AI agents are the future!"}' | python3 -m json.tool

curl -s https://aipaygen.com/search \
  -H "Content-Type: application/json" \
  -d '{"query": "x402 protocol", "n": 3}' | python3 -m json.tool

curl -s https://aipaygen.com/code \
  -H "Content-Type: application/json" \
  -d '{"description": "REST API server with Express", "language": "javascript"}'

curl -s https://aipaygen.com/chain \
  -H "Content-Type: application/json" \
  -d '{
    "steps": [
      {"tool": "research", "input": {"query": "quantum computing"}},
      {"tool": "summarize", "input": {"text": "$prev.result"}}
    ]
  }' | python3 -m json.tool

# Generate an API key first
curl -s https://aipaygen.com/auth/generate-key \
  -H "Content-Type: application/json" \
  -d '{"name": "my-app"}'

# Then use it in requests
curl -s https://aipaygen.com/research \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_KEY_HERE" \
  -d '{"question": "What is the x402 payment protocol?"}'

import requests
from langchain.tools import Tool
from langchain.agents import initialize_agent, AgentType
from langchain_openai import ChatOpenAI

BASE = "https://aipaygen.com"
API_KEY = "your-api-key"
HEADERS = {"Content-Type": "application/json", "X-API-Key": API_KEY}


def aipaygen_search(query: str) -> str:
    """Search the web using AiPayGen."""
    r = requests.post(f"{BASE}/search", json={"query": query, "n": 5}, headers=HEADERS)
    return str(r.json())


def aipaygen_summarize(text: str) -> str:
    """Summarize text using AiPayGen."""
    r = requests.post(f"{BASE}/summarize", json={"text": text}, headers=HEADERS)
    return r.json().get("summary", str(r.json()))


def aipaygen_sentiment(text: str) -> str:
    """Analyze sentiment using AiPayGen."""
    r = requests.post(f"{BASE}/sentiment", json={"text": text}, headers=HEADERS)
    return str(r.json())


# Define LangChain tools
tools = [
    Tool(name="WebSearch", func=aipaygen_search,
         description="Search the web for current information"),
    Tool(name="Summarize", func=aipaygen_summarize,
         description="Summarize a long text into key points"),
    Tool(name="Sentiment", func=aipaygen_sentiment,
         description="Analyze the sentiment of text"),
]

# Create an agent
llm = ChatOpenAI(model="gpt-4")
agent = initialize_agent(tools, llm, agent=AgentType.ZERO_SHOT_REACT_DESCRIPTION)

# Run it
result = agent.run("Search for 'x402 protocol', then summarize what you find")
print(result)

{
  "mcpServers": {
    "aipaygen": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.aipaygen.com/mcp"
      ]
    }
  }
}

# Install from PyPI
pip install aipaygen-mcp

# Run the MCP server
aipaygen-mcp --api-key YOUR_KEY

# Or add to claude_desktop_config.json:
# {
#   "mcpServers": {
#     "aipaygen": {
#       "command": "aipaygen-mcp",
#       "args": ["--api-key", "YOUR_KEY"]
#     }
#   }
# }

# In Claude Desktop / Cursor / Claude Code, just say:

"Use aipaygen to search for the latest AI agent news"

"Analyze the sentiment of this customer review: ..."

"Research x402 protocol, summarize it, and translate to French"

"Generate a Python REST API with authentication"

"Scrape https://example.com and extract the main topics"

# Claude will automatically call the right AiPayGen MCP tools!

# Install via Smithery CLI
npx @smithery/cli install Damien829/Aipaygen

# Or visit: https://smithery.ai/servers/Damien829/Aipaygen