TPMJS

Sharing & URLs

Learn how to share your agents, collections, and profile with others using human-readable URLs.

Overview

TPMJS uses human-readable URLs based on your username. When you create an account, you choose a unique username that becomes part of your shareable URLs.

👤

User Profiles

Share your profile page showing all your public agents and collections

🤖

Agents

Share individual agents so others can chat with them or clone them

📦

Collections

Share tool collections for easy MCP server setup

Note: Only public agents and collections are visible to others. You can control visibility in the settings for each item.

User Profiles

Your profile page displays your name, avatar, and all your public agents and collections.

Profile URL

tpmjs.com/{username}

Your public profile page. Shows all your public agents and collections.

Example: tpmjs.com/ajax

You can also use the @ prefix for social-media style URLs:

tpmjs.com/@{username}

Alternative format with @ prefix. Works identically to the version without @.

Example: tpmjs.com/@ajax

Choosing a Username

Usernames must be 3-30 characters and can contain lowercase letters, numbers, and hyphens. They cannot start or end with a hyphen.

Valid usernames:
- ajax
- john-doe
- dev123
- my-cool-name

Invalid usernames:
- -invalid (starts with hyphen)
- also-invalid- (ends with hyphen)
- Hi (uppercase not allowed)
- ab (too short)

Agents

Share your AI agents so others can interact with them or clone them to their own account.

Agent Detail Page

tpmjs.com/{username}/agents/{agent-uid}

View an agent's details including its system prompt, attached tools, and model configuration.

Example: tpmjs.com/ajax/agents/research-assistant

The agent UID is auto-generated from the agent name when you create it. For example, an agent named "Research Assistant" gets the UID "research-assistant".

Chat with Agent

tpmjs.com/{username}/agents/{agent-uid}/chat

Open a chat interface to interact with the agent directly.

Example: tpmjs.com/ajax/agents/research-assistant/chat

Note: Chatting with someone else's agent uses their API keys and tool configuration. The agent owner is responsible for any API usage costs.

Collections

Collections bundle multiple tools together for easy sharing and MCP server setup.

Collection Page

tpmjs.com/{username}/collections/{collection-slug}

View a collection with all its tools and MCP server URLs.

Example: tpmjs.com/ajax/collections/web-scraping-tools

Collection pages include ready-to-use MCP server URLs that others can copy into their Claude Desktop or Cursor configuration.

MCP Server URLs

Each collection provides HTTP and SSE transport URLs:

{
  "mcpServers": {
    "tpmjs-collection": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://tpmjs.com/api/mcp/{username}/{collection-slug}/http",
        "--header",
        "Authorization: Bearer YOUR_TPMJS_API_KEY"
      ]
    }
  }
}

Tools

Tools in the registry have URLs based on their npm package name and tool name.

Tool Page

tpmjs.com/tool/{package-name}/{tool-name}

View a tool's documentation, parameters, and usage examples.

Example: tpmjs.com/tool/@anthropic-ai/mcp-fetch/fetch

Tools are not user-owned - they come from npm packages published with the tpmjs keyword.

Clone Agents

When you find a public agent you like, you can clone it to your own account to customize it.

How to Clone

1. Navigate to a public agent's detail page (e.g., tpmjs.com/ajax/agents/research-assistant)

2. Click the "Clone" button in the header

3. The agent is copied to your account with all its tools and settings

4. You'll be redirected to your dashboard where you can customize the cloned agent

What Gets Cloned

Included

  • • Name and description
  • • System prompt
  • • Provider and model settings
  • • Temperature and other parameters
  • • All attached tools
  • • All attached collections

Not Included

  • • Conversation history
  • • API keys (you use your own)
  • • Like count
  • • Original owner attribution

Clone Collections

Clone collections to get a copy you can modify without affecting the original.

How to Clone

1. Navigate to a public collection's detail page (e.g., tpmjs.com/ajax/collections/web-scraping)

2. Click the "Clone" button

3. The collection is copied to your account with all its tools

4. You can then add, remove, or reorder tools as you like

What Gets Cloned

Included

  • • Name and description
  • • All tools in the collection
  • • Tool order
  • • Tool notes

Not Included

  • • Like count
  • • Original owner attribution
  • • MCP server URLs (new ones generated)

URL Reference

Complete reference of all shareable URLs on TPMJS.

TypeURL PatternExample
User Profile/{username}/ajax
User Profile (@)/@{username}/@ajax
Agent Detail/{username}/agents/{uid}/ajax/agents/research-bot
Agent Chat/{username}/agents/{uid}/chat/ajax/agents/research-bot/chat
Collection/{username}/collections/{slug}/ajax/collections/web-tools
Tool/tool/{package}/{tool}/tool/@firecrawl/ai-sdk/scrape
API Endpoints
MCP Server (HTTP)/api/mcp/{username}/{slug}/http/api/mcp/ajax/web-tools/http
MCP Server (SSE)/api/mcp/{username}/{slug}/sse/api/mcp/ajax/web-tools/sse
Agent Conversation/api/{username}/agents/{uid}/conversation/{id}/api/ajax/agents/research-bot/conversation/abc123

Visibility Settings

Control who can see your agents and collections.

Public vs Private

Public

  • • Visible on your profile page
  • • Anyone can view the detail page
  • • Can be cloned by other users
  • • Shows up in search results
  • • Others can chat with public agents

Private

  • • Only visible to you
  • • Not shown on profile
  • • Cannot be cloned
  • • Direct URL returns 404 for others
  • • Only you can chat with the agent

Changing Visibility

To change an item's visibility:

1. Go to your dashboard (Dashboard → Agents or Dashboard → Collections)

2. Click on the item you want to modify

3. Toggle the "Public" switch

4. Changes take effect immediately

Start Sharing

Create public agents and collections to share your work with the community.