@tpmjs/tools-openrouter

Complete OpenRouter API tools for AI agents. 33 tools covering chat completions, embeddings, model discovery, API key management, credits, analytics, and guardrails.

Installation

npm install @tpmjs/tools-openrouter

Environment Variables

Variable	Required	Description
`OPENROUTER_API_KEY`	Yes	Your OpenRouter API key
`OPENROUTER_REFERER`	No	HTTP Referer header (default: https://tpmjs.com)
`OPENROUTER_TITLE`	No	X-Title header (default: TPMJS Agent)

Tools

Chat & AI

Tool	Description
`chatCompletion`	Send chat completions to 400+ models
`createResponse`	Responses API (beta)
`createEmbedding`	Generate text embeddings

Models & Discovery

Tool	Description
`listModels`	List all models with pricing
`countModels`	Get total model count
`listUserModels`	Models filtered by user prefs
`listEmbeddingModels`	List embedding models
`listProviders`	List all providers
`listEndpoints`	Endpoints for a specific model
`previewZdr`	Preview ZDR impact

Account

Tool	Description
`getCredits`	Get remaining credits
`createCoinbaseCharge`	Add credits via crypto
`getUserActivity`	Usage analytics
`getGeneration`	Generation metadata by ID

API Keys

Tool	Description
`listApiKeys`	List all API keys
`createApiKey`	Create new key
`getApiKey`	Get key by hash
`getCurrentApiKey`	Get current key details
`updateApiKey`	Update key settings
`deleteApiKey`	Delete a key

Guardrails

Tool	Description
`listGuardrails`	List all guardrails
`createGuardrail`	Create guardrail
`getGuardrail`	Get guardrail details
`updateGuardrail`	Update guardrail
`deleteGuardrail`	Delete guardrail
`listGuardrailKeyAssignments`	All key assignments
`listGuardrailMemberAssignments`	All member assignments
`getGuardrailKeys`	Keys for a guardrail
`assignGuardrailKeys`	Assign keys
`getGuardrailMembers`	Members for a guardrail
`assignGuardrailMembers`	Assign members
`unassignGuardrailKeys`	Unassign keys
`unassignGuardrailMembers`	Unassign members

Usage

import { chatCompletion, listModels, getCredits } from '@tpmjs/tools-openrouter';

// Chat completion
const result = await chatCompletion.execute({
  model: 'openai/gpt-4o',
  messages: [{ role: 'user', content: 'Hello!' }],
});

// List models
const models = await listModels.execute({});

// Check credits
const credits = await getCredits.execute({});

License

MIT