# Capacities MCP for AI Agents AI Agent Connect

> Capacities MCP lets your AI agents read and write directly to your Capacities knowledge base. It handles object creation, space navigation, and daily note updates so your agent can manage your personal knowledge graph without you having to copy-paste data manually. It turns your personal notes into a live, interactive database that your AI client can actually use to help you work.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_ZID8SH13sQKM0vE5SjxHLtpxSSu31LjQiFG07vWF/ai-agent-connect
- **Tags:** knowledge-graph, object-oriented, personal-knowledge-management, unstructured-data, ai-agents, data-modeling

## Description

This Capacities MCP connects your personal knowledge graph directly to your AI client. Instead of manually moving notes from one app to another, your agent can now navigate your spaces, find specific objects, and update your records in real-time. If you're building a research database or a complex project log, this means you can just tell your agent to "add this to my research" and it actually happens. You can find it in the Vinkius catalog to get your workspace synced. It handles the heavy lifting of understanding your specific object structures, so your agent doesn't get lost in your data. You get a way to turn a conversation into a structured record without leaving your chat window. It bridges the gap between a static note-taking app and a dynamic, AI-powered workspace where your data is actually useful and reachable. You can ask your agent to summarize your notes, find specific links you saved last month, or even create new entries for your projects based on a quick chat. It handles the complexity of your object types so you don't have to worry about formatting. This means no more lost links or forgotten thoughts, just a clean, organized graph that grows as you work.

## Tools

### get_structures
View the metadata and definitions for every object type in a space. This ensures the agent knows the rules for creating new entries.

### lookup
Search for specific content or keywords within a single space. It helps you find specific nodes in your graph quickly.

### save_weblink
Add a URL as a Weblink object with automatic previews. This is perfect for quickly saving research sources.

### save_to_daily_note
Add Markdown text to your mapped daily note for quick logging. Use this to dump thoughts or summaries into your daily log.

### get_space_info
Get the details of a space, including its specific object types and properties. Use this to see how your data is structured.

### list_spaces
See all your top-level containers in Capacities. This helps your agent understand the high-level organization of your data.

### create_object
Make a new typed object that fits your specific graph rules. This allows the agent to build new entities in your workspace.

### get_object
Pull the full data for a specific object using its ID. Use this to let your agent read the full context of a specific note.

### save_media
Attach an image or media file to an existing record. This helps keep your knowledge graph visually organized.

### add_tag
Apply a categorical tag to group your graph items together. This keeps your related content linked and easy to find.

## Prompt Examples

**Prompt:** 
```
Search my 'Research' space for the product launch meeting notes and summarize them.
```

**Response:** 
```
I've looked through your Research space and found the 'Q1 Product Launch Sync' notes. Here are the key takeaways:

* **Marketing:** Campaign goes live next Tuesday.
* **Dev-Ops:** Staging environment is now complete.
* **Next Steps:** Finalize the press release by Friday.

Would you like me to add a 'Completed' tag to this note?
```

**Prompt:** 
```
Save this URL https://example.com to my 'Research' space as a new Weblink.
```

**Response:** 
```
I've added that link to your Research space as a new Weblink. It now includes an automatic preview and is organized within your existing graph.
```

**Prompt:** 
```
Append the code I just wrote to my daily note to remember the bugfix.
```

**Response:** 
```
I've added that Python snippet and your summary to today's daily note. It's now logged in your primary space for easy reference later.
```

## Capabilities

### Navigate your spaces
Your agent can see all your top-level containers to find the right place for new data.

### Create typed objects
The agent builds new entries that follow your specific graph rules and property definitions.

### Update daily logs
Automatically append summaries or Markdown text into your mapped daily note for quick logging.

### Search your graph
Find specific nodes or content across your entire workspace using keywords.

### Save web links
Inject URLs into your space as Weblinks with automatic preview generation.

### Manage media
Attach images and files directly onto existing records to keep your data rich.

### Apply tags
Group related items using your existing categorical tags to maintain a clean graph.

## Use Cases

### Capturing research sources
A researcher finds a great article and asks their agent to "Save this link to my Biology space." The agent uses `save_weblink` to add it with a preview.

### Meeting preparation
A manager asks their agent to "Find my notes on Project X and summarize the last three updates." The agent uses `lookup` to pull the data.

### Structured documentation
A developer asks their agent to "Create a new System Architecture object with these specs." The agent uses `create_object` to build a structured record.

### Quick thought logging
A writer wants to save a thought. They tell the agent "Add this thought to my daily note." The agent uses `save_to_daily_note` to append the text.

## Benefits

- Stop manually copying links. Use `save_weblink` to let your agent grab URLs and create previews in your research space automatically.
- Keep your daily logs updated. Use `save_to_daily_note` to push summaries or code snippets into your notes without switching tabs.
- Query your own data faster. Use `lookup` and `get_object` to have your agent find specific details across your workspace.
- Maintain a clean graph. Use `create_object` to ensure every new entry follows your predefined structures and rules.
- Organize content instantly. Use `add_tag` and `save_media` to keep your records categorized and visually rich.

## How It Works

The bottom line is it turns your personal knowledge base into a live, editable database for your AI.

1. Get your Personal Token from the Capacities app settings.
2. Connect the Connector via the Vinkius dashboard.
3. Start giving your agent commands to read, write, or organize your notes.

## Frequently Asked Questions

**How does the Capacities MCP help with my personal knowledge management?**
It connects your Capacities workspace to your AI client so you can manage your notes using natural language. You can ask your agent to find, create, or update objects without manually clicking through your folders.

**Can the Capacities MCP automatically organize my research links?**
Yes, it can. You can tell your agent to save URLs as Weblink objects, and it will handle the injection into your specific spaces while generating previews automatically.

**Will the Capacities MCP mess up my existing note structures?**
No, it's designed to follow your rules. The agent can check your object structures first to ensure every new entry it creates matches your predefined graph parameters.

**Can I use the Capacities MCP to search my old notes for specific info?**
Absolutely. You can ask your agent to look up specific keywords or titles across your spaces to find old notes, meeting summaries, or project details instantly.

**Does the Capacities MCP support adding images to my notes?**
Yes, it can attach media payloads to your existing records. This allows your AI agent to help you build a more visually rich and complete knowledge graph.

**Is the Capacities MCP good for daily journaling?**
It's great for that. You can have your agent append summaries, thoughts, or even code snippets directly into your daily note log as you work through your day.

**Can my AI agent automatically funnel research links into my Capacities daily note?**
Yes. It can append raw Markdown to your Daily Note dynamically, or use the dedicated WebLink endpoint to natively scrape and save beautifully previewed URLs into your specified space. This gives you a fast workflow for daily link-hoarding right from your chat tools.

**Will the agent know the specific object structures configured in my custom Capacities space?**
Absolutely. Before creating nodes, your agent pulls constraints using the `get_structures` capability. It reads the schemas, understands which properties are locked or required (e.g., Dates vs Checkboxes), and constructs the new object JSON mapping perfectly inside the space.

**Is the agent capable of categorizing objects with new tags automatically?**
Yes. Once an object is created or fetched via lookup, the AI can employ the tag modification tool to link categorical boundaries accurately. It's a frictionless way to organize hundreds of loosely coupled notes into connected knowledge topics without any manual toggles.