# Common Paper MCP MCP

> Common Paper connects your contract workflow to your AI agent. Use this MCP to send agreements like NDAs or CSAs, track who signs them, and get a full status list of every document you've ever sent out.

## Overview
- **Category:** document-management
- **Price:** Free
- **Tags:** contract-lifecycle, agreement-tracking, nda, csa, dpa, workflow-automation

## Description

This MCP lets you manage all commercial contracts through natural conversation. Instead of logging into separate legal platforms to check on deals, your agent handles the process for you. You can ask it to find agreements associated with a specific person or get a full list of executed documents. Need to start a new deal? Just tell it to send out an agreement using a predefined template, like a NDA or a CSA. The system records everything, so you always know where a contract stands in the signing process. It’s all available through Vinkius, keeping your whole catalog of services connected to one place. Your agent becomes a dedicated contracting assistant that tracks every detail.

## Tools

### create_webhook
Sets up a new webhook to receive automatic updates when a contract status changes.

### delete_webhook
Removes a webhook that was previously configured for monitoring contract status.

### get_agreement
Retrieves detailed information about one specific agreement using its ID.

### get_template
Fetches the details for a particular contract template you use regularly.

### list_agreements
Retrieves a comprehensive list of all agreements recorded in your account.

### list_signed_agreements
Quickly generates a list containing only the contracts that have been fully signed.

### list_templates
Gets a list of all contract templates available inside your Common Paper account.

### list_webhooks
Retrieves a list showing every webhook you currently have set up.

### search_agreements_by_email
Finds and returns any agreements linked to a specific person's email address.

### send_agreement
Creates and sends out an entirely new agreement using one of your existing templates.

## Prompt Examples

**Prompt:** 
```
Show me all signed agreements in Common Paper.
```

**Response:** 
```
I found 5 signed agreements in your Common Paper account. Would you like me to display their details?
```

**Prompt:** 
```
Send an NDA agreement to 'partner@example.com' using template ID 'tmpl-xxxx' in Common Paper.
```

**Response:** 
```
I've successfully sent the NDA agreement to 'partner@example.com'. The agreement status is currently pending signature.
```

**Prompt:** 
```
Get the current status of agreement 'agr-yyyy' in Common Paper.
```

**Response:** 
```
The agreement 'agr-yyyy' is currently fully executed. It was signed on March 15, 2026.
```

## Capabilities

### Send and track new agreements
Create and send out specific documents, such as NDAs or CSAs, using pre-set templates.

### Get a complete list of contracts
Retrieve lists of every agreement in your account, including only those that are fully signed.

### Find agreements by person
Search through all records to locate any contract linked to a specific recipient email address.

### Monitor status changes
Configure webhooks so your agent automatically gets notified when the status of an agreement changes.

### View detailed document records
Retrieve full details and history for any specific contract or template by name or ID.

## Use Cases

### A sales rep needs to send a contract quickly.
The agent handles the process: it uses `send_agreement` to push an NDA to 'client@corp.com' and immediately reports back that the agreement is pending signature, allowing the rep to follow up without switching tabs.

### Legal Ops needs to audit compliance.
Instead of running multiple reports, the agent uses `list_agreements` followed by `get_agreement` on specific IDs. This builds an instant, conversational overview of every executed contract in the system.

### A founder needs to find a past deal.
The founder asks for agreements related to 'john@example.com'. The agent uses `search_agreements_by_email` and returns the list, immediately pinpointing the necessary document.

### Need to monitor recurring compliance checks?
The agent sets up a webhook using `create_webhook`. Now, whenever any contract status changes—signed, rejected, or pending—your AI client gets an instant alert without you having to check the system manually.

## Benefits

- You stop manually checking status. Use the `create_webhook` tool to automatically notify your agent whenever a contract's status changes, keeping you instantly informed.
- Closing deals gets faster. By using the `send_agreement` tool, you can immediately push out NDAs or CSAs to prospects without leaving your current conversation flow.
- Never lose track of documents again. The `search_agreements_by_email` tool lets you find all contracts tied to a specific person instantly.
- Get a clear audit trail by running the `list_signed_agreements` tool, which pulls together only those deals that are fully executed and locked down.
- Understand your options with the `list_templates` tool. See exactly what boilerplate agreements you have ready to deploy when needed.

## How It Works

The bottom line is that you manage your contract lifecycle entirely through conversation with your AI client.

1. Subscribe to this MCP and enter your Common Paper API key.
2. Tell your AI client what you need, like 'Show me all signed agreements' or 'Send an NDA to partner@example.com'.
3. The agent executes the action using the connection, sending back real-time status updates and data.

## Frequently Asked Questions

**How do I check the status of an agreement using get_agreement?**
You give the agent the specific agreement ID, and it pulls detailed information. It tells you if the contract is fully executed, pending signature, or rejected.

**What's the difference between list_agreements and list_signed_agreements?**
`list_agreements` gives you every contract in your account. `list_signed_agreements` only gives you those that have successfully been completed, making audits much faster.

**Can I track a deal using search_agreements_by_email?**
Yes. If you know the recipient's email, the agent uses `search_agreements_by_email` to pull up every agreement associated with that person.

**Do I need to manually configure webhooks for status updates?**
No. You use the `create_webhook` tool once, and then your agent handles all future notifications automatically when a contract changes state.

**How do I use list_templates to see all available contract options?**
The tool returns a directory of every standard template in your account. This lets you review which types of agreements, like NDAs or CSAs, are ready to be deployed.

**What information does send_agreement need to successfully dispatch a new contract?**
You must provide the target recipient's email, and the unique ID for the template you want to use. The system then generates and sends the agreement automatically.

**If I stop using a webhook, how do I use delete_webhook?**
You simply provide the existing webhook ID to remove it from your configuration. This is critical for clean maintenance and preventing unnecessary data flow or errors.

**How does get_agreement give me more than just a status update?**
It pulls the entire record history of that specific agreement. You receive all metadata, including signatures, creation dates, and any associated changes made over time.

**How do I get my Common Paper API key?**
You can generate an API key in your Common Paper account under Settings > Integrations.

**Which agreement types are supported?**
Common Paper supports standard contracts like NDAs, Cloud Service Agreements (CSA), and Data Processing Agreements (DPA).

**Can I use custom templates?**
Yes, you can use any template created in your Common Paper account by providing its unique template ID to the 'send_agreement' tool.