What can you do with this server?

Manages Trollspace data through MCP tools. * Create, list, get, update, and delete snippets, nuggets, todo lists, ideas, software tools, repos, travel locations, subscriptions, and payments. * Import software tools from URLs and GitHub repos (GitHub import requires integration). * Browse read-only country and city reference data for travel. * Filter lists by fields such as status, category, usage type, billing cycle, dates, source, and subscription. * Manage subscription payments: mark paid, backfill historical records, and list payments across subscriptions. * Send natural-language requests to the Trollspace agent.

Which integrations are available for this server?

Enables importing GitHub repositories by URL into the Trollspace repo catalog, automatically fetching repository metadata, stars, primary language, topics, and README content (requires a connected GitHub integration).

How do I use trollspace-mcp?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@trollspace-mcp List my code snippets" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

trollspace-mcp

by da-troll

Overview Schema Source Related Servers Discussions Admin

TypeScript

Remote

trollspace-mcp

MCP server for the Trollspace API — exposes 47 type-safe tools for managing snippets, nuggets, todos, ideas, tools, repos, travel, subscriptions, and more.

Built with the Model Context Protocol SDK, openapi-fetch, and TypeScript types auto-generated from the OpenAPI spec.

Setup

Prerequisites

Node.js >= 18
A Trollspace API key

Install & Build

npm install
npm run build

Configuration

Set your API key as an environment variable:

export TROLLSPACE_API_KEY="troll_usr_your_key_here"
# Household box: no raw key; run through Agent Vault with scripts/run-via-vault.sh (HIVE-1433)

Usage with Claude Desktop

Add this to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "trollspace": {
      "command": "node",
      "args": ["/path/to/troll-mcp/dist/index.js"],
      "env": {
        "TROLLSPACE_API_KEY": "troll_usr_your_key_here"
      }
    }
  }
}

Usage with Claude Code

Add to your Claude Code MCP settings:

claude mcp add trollspace -- node /path/to/troll-mcp/dist/index.js

Set the API key in your environment or pass it via the env config.

Related MCP server: ts-mcp-meta

Tools

Snippets

Code snippets and quick references.

Tool	Description
`list_snippets`	List all code snippets
`get_snippet`	Get a snippet by ID
`create_snippet`	Create a new snippet (name, description, code, language, tags)
`update_snippet`	Update an existing snippet
`delete_snippet`	Delete a snippet

Nuggets

Knowledge notes and insights.

Tool	Description
`list_nuggets`	List all nuggets
`get_nugget`	Get a nugget by ID
`create_nugget`	Create a new nugget (name, description, content)
`update_nugget`	Update an existing nugget
`delete_nugget`	Delete a nugget

Todos

Task management lists.

Tool	Description
`list_todos`	List all todo lists
`get_todo`	Get a todo list by ID
`create_todo`	Create a new todo list (name, description, content)
`update_todo`	Update an existing todo list
`delete_todo`	Delete a todo list

Ideas

Project and content ideas.

Tool	Description
`list_ideas`	List all ideas
`get_idea`	Get an idea by ID
`create_idea`	Create a new idea (name, content)
`update_idea`	Update an existing idea
`delete_idea`	Delete an idea

Tools

Software tools and resources catalog.

Tool	Description
`list_tools`	List all software tools
`get_tool`	Get a tool by ID
`create_tool`	Create a new tool entry (name, url, category, description, rating)
`update_tool`	Update an existing tool entry
`delete_tool`	Delete a tool entry

Repos

Git repositories and projects.

Tool	Description
`list_repos`	List all repositories
`get_repo`	Get a repo by ID
`create_repo`	Create a new repo entry (title, summary, description_md, repo_url, source_type)
`update_repo`	Update an existing repo entry
`delete_repo`	Delete a repo entry

Travel

Travel locations and experiences.

Tool	Description
`list_travel`	List travel locations (filter by status, location_type)
`get_travel`	Get a travel location by ID
`create_travel`	Add a travel location (location_id, location_type, status, dates, notes)
`update_travel`	Update a travel location
`delete_travel`	Remove a travel location

Countries & Cities

Read-only reference data for use with travel tools.

Tool	Description
`list_countries`	List countries (search by name, filter by continent)
`get_country`	Get a country by ID
`list_cities`	List cities (search by name, filter by country_id)
`get_city`	Get a city by ID

Subscriptions

Recurring subscription management.

Tool	Description
`list_subscriptions`	List subscriptions (filter by status, category, usage_type, billing_cycle)
`get_subscription`	Get a subscription by ID
`create_subscription`	Create a subscription (name, amount, currency, billing_cycle, usage_type)
`update_subscription`	Update a subscription
`delete_subscription`	Delete a subscription (payment history preserved)
`mark_subscription_paid`	Record a payment and advance the next billing date
`backfill_subscription`	Generate historical payment records for past periods
`list_subscription_payments`	List payments for a specific subscription

Subscription Payments

Payment records across all subscriptions.

Tool	Description
`list_all_payments`	List all payments (filter by subscription, status, usage_type, source, date range)
`get_payment`	Get a payment by ID
`create_payment`	Create a payment record
`update_payment`	Update a payment record
`delete_payment`	Delete a payment record

Agent

Tool	Description
`agent_query`	Send a natural language request to the Trollspace agent

Development

Regenerate API types

If the OpenAPI spec changes, regenerate the TypeScript types:

npm run generate-types

Project structure

src/
  client.ts          # Type-safe API client (openapi-fetch + generated types)
  index.ts           # MCP server entry point with all tool definitions
  types/api.d.ts     # Auto-generated OpenAPI types (do not edit)

License

ISC

Available Tools

55 tools

agent_queryA

Send a natural language request to the Trollspace agent for complex operations

Inputs: message (required).

backfill_subscriptionB

Generate historical payment records for past billing periods

Inputs: id (required), periods (required), amount (required), currency (required), +2 more.

create_ideaB

Create a new idea

Inputs: name (required), content (required).

create_nuggetC

Create a new knowledge nugget

Inputs: name (required), description (required), content (required).

create_paymentB

Manually create a payment record for a subscription

Inputs: subscription_id (required), payment_date (required), amount (required), currency (required), +3 more.

create_repoC

Create a new git repository entry

Inputs: title (required), source_type (required), summary, description_md, +1 more.

create_snippetC

Create a new code snippet

Inputs: name (required), description (required), code (required), language (required), +1 more.

create_subscriptionC

Create a new subscription

Inputs: name (required), amount (required), currency (required), billing_cycle (required), +6 more.

create_todoC

Create a new todo list

Inputs: name (required), description (required), content (required).

create_toolB

Create a new software tool entry

Inputs: name (required), url, category, description, +1 more.

create_travelA

Add a new travel location. Use list_countries or list_cities to find the location_id first.

Inputs: location_id (required), location_type (required), status (required), is_favorite (required), +3 more.

delete_ideaB

Delete an idea

Inputs: id (required).

delete_nuggetB

Delete a knowledge nugget

Inputs: id (required).

delete_paymentB

Permanently delete a payment record

Inputs: id (required).

delete_repoC

Delete a git repository entry

Inputs: id (required).

delete_snippetB

Delete a code snippet

Inputs: id (required).

delete_subscriptionB

Delete a subscription (payment history is preserved)

Inputs: id (required).

delete_todoB

Delete a todo list

Inputs: id (required).

delete_toolB

Delete a software tool entry

Inputs: id (required).

delete_travelC

Remove a travel location

Inputs: id (required).

get_cityC

Get a city by ID

Inputs: id (required).

get_countryC

Get a country by ID

Inputs: id (required).

get_ideaA

Get an idea by ID

Inputs: id (required).

get_nuggetA

Get a knowledge nugget by ID

Inputs: id (required).

get_paymentA

Get a subscription payment by ID

Inputs: id (required).

get_repoA

Get a git repository by ID

Inputs: id (required).

get_snippetA

Get a code snippet by ID

Inputs: id (required).

get_subscriptionB

Get a subscription by ID

Inputs: id (required).

get_todoB

Get a todo list by ID

Inputs: id (required).

get_toolA

Get a software tool by ID

Inputs: id (required).

get_travelB

Get a travel location by ID

Inputs: id (required).

import_repoA

Import a repository from GitHub by URL. Auto-fetches metadata, stars, language, topics, and README content. Requires GitHub integration to be connected.

Inputs: url (required), name, is_public.

import_toolB

Import a software tool from a URL. Auto-detects name and description from the webpage.

Inputs: url (required), name, description, category, +1 more.

list_all_paymentsA

List payment records across all subscriptions

Inputs: limit, subscription_id, status, usage_type, +3 more.

list_citiesC

List cities (reference data for travel)

Inputs: limit, search, country_id.

list_countriesB

List countries (reference data for travel)

Inputs: limit, search, continent.

list_ideasC

List all ideas

Inputs: limit.

list_nuggetsC

List all knowledge nuggets

Inputs: limit.

list_reposC

List all git repositories

Inputs: limit.

list_snippetsB

List all code snippets

Inputs: limit.

list_subscription_paymentsC

List payment records for a specific subscription

Inputs: id (required), limit.

list_subscriptionsC

List all subscriptions

Inputs: limit, status, category, usage_type, +1 more.

list_todosC

List all todo lists

Inputs: limit.

list_toolsB

List all software tools and resources

Inputs: limit.

list_travelC

List travel locations

Inputs: limit, status, location_type.

mark_subscription_paidB

Record a payment for the current billing period and advance the next billing date

Inputs: id (required).

update_ideaC

Update an existing idea

Inputs: id (required), name, content.

update_nuggetB

Update an existing knowledge nugget

Inputs: id (required), name, description, content.

update_paymentC

Update an existing payment record

Inputs: id (required), amount, currency, status, +2 more.

update_repoB

Update an existing git repository entry

Inputs: id (required), title, summary, description_md, +2 more.

update_snippetC

Update an existing code snippet

Inputs: id (required), name, description, code, +2 more.

update_subscriptionC

Update an existing subscription

Inputs: id (required), name, category, amount, +8 more.

update_todoC

Update an existing todo list

Inputs: id (required), name, description, content.

update_toolB

Update an existing software tool entry

Inputs: id (required), name, url, category, +2 more.

update_travelC

Update an existing travel location

Inputs: id (required), status, date_from, date_to, +2 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

B3.2/5.0

Scored 2026-05-26 10:10 across 55 tools

Disambiguation4/5

Most tools target distinct resource-action pairs, but 'create_tool' vs 'import_tool' and 'list_all_payments' vs 'list_subscription_payments' have overlapping purposes. 'agent_query' is vague. Overall, still fairly distinct.

Naming Consistency5/5

All tool names follow a consistent verb_noun pattern, with verbs like create, delete, get, list, update. Deviations like 'backfill_subscription' and 'import_tool' still fit the pattern. No mixed conventions.

Tool Count2/5

55 tools is excessive for a single MCP server. The server aggregates many unrelated domains (ideas, repos, travel, payments, etc.), making it unwieldy for agents to navigate.

Completeness4/5

Each resource type has full CRUD operations, plus additional useful operations like imports and payment backfill. Minor gaps exist (e.g., no search across resources), but the set is fairly complete for the described domains.

Maintenance

ActivityMaintained

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

mcp-server
com.niftypm
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Project Management Communication File Systems
2
https://mcp.niftypm.com/mcp
strata
ai.klavis
MCP server for progressive tool usage at any scale (see https://klavis.ai)
Agent Orchestration Autonomous Agents Developer Tools
25,748
https://strata.klavis.ai/mcp/
Smia
io.github.Smia-Technologies-AS
Build your own tools from chat: design, test and host them on a shareable MCP server URL.
Developer Tools Agent Orchestration
1
https://app.smia.io/mcp?src=mcp-registry
Flowra
io.github.flowradev
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Agent Orchestration Autonomous Agents
11
https://mcp.flowra.dev/mcp

Related MCP Servers

openapi-to-mcp
Developer Tools API Testing Documentation Access
kirkwat
A
license
Not graded
quality
C
maintenance
A minimal MCP server that auto-generates tools from your OpenAPI spec, optimized for Vercel.
Updated a month ago (2026-10-13 17:49 UTC)
17 npm
8
MIT
ts-mcp-meta
Developer Tools Code Execution Agent Orchestration
Pearcekieser
F
license
Not graded
quality
D
maintenance
Aggregates tools from multiple MCP servers, generates TypeScript definitions, and executes custom TypeScript scripts to orchestrate cross-server tool calls.
Updated a year ago (2025-10-08 05:56 UTC)
-
basecamp-mcp
Project Management Communication
FarisHijazi
A
license
Not graded
quality
D
maintenance
MCP server exposing Basecamp CLI commands as tools for project management, todos, messages, and more.
Updated 7 months ago (2026-04-08 13:00 UTC)
MIT
trello-mcp
Project Management Product Management
trinknx
A
license
B
quality
D
maintenance
An MCP server for the Trello REST API. Exposes ~36 curated tools for boards, lists, cards, checklists, labels, members, and search.
Updated 4 months ago (2026-07-14 16:40 UTC)
36
8 npm
MIT

trollspace-mcp

Setup

Prerequisites

Install & Build

Configuration

Usage with Claude Desktop

Usage with Claude Code

Tools

Snippets

Nuggets

Todos

Ideas

Tools

Repos

Travel

Countries & Cities

Subscriptions

Subscription Payments

Agent

Development

Regenerate API types

Project structure

License

Available Tools

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

openapi-to-mcp

ts-mcp-meta

basecamp-mcp

trello-mcp